@khanacademy/perseus 72.0.0 → 72.1.0

package/dist/util.d.ts

@@ -167,7 +167,6 @@ declare const Util: {
     readonly rTypeFromWidgetId: RegExp;
     readonly rWidgetParts: RegExp;
     readonly snowman: "☃";
-    readonly split: (str: string, r: RegExp) => ReadonlyArray<string>;
     readonly firstNumericalParse: typeof firstNumericalParse;
     readonly stringArrayOfSize: typeof stringArrayOfSize;
     readonly stringArrayOfSize2D: typeof stringArrayOfSize2D;

package/dist/widgets/categorizer/categorizer.d.ts

@@ -1,11 +1,12 @@
 import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
-import type { Widget, WidgetProps } from "../../types";
+import type { PerseusDependenciesV2, Widget, WidgetProps } from "../../types";
 import type { CategorizerPromptJSON } from "../../widget-ai-utils/categorizer/categorizer-ai-utils";
 import type { PerseusCategorizerWidgetOptions, PerseusCategorizerUserInput } from "@khanacademy/perseus-core";
 type ExternalProps = WidgetProps<PerseusCategorizerWidgetOptions, PerseusCategorizerUserInput>;
 type Props = ExternalProps & {
     linterContext: NonNullable<ExternalProps["linterContext"]>;
+    dependencies: PerseusDependenciesV2;
 };
 type DefaultProps = Pick<Props, "items" | "categories" | "linterContext" | "userInput">;
 type State = {
@@ -16,6 +17,7 @@ export declare class Categorizer extends React.Component<Props, State> implement
     context: React.ContextType<typeof PerseusI18nContext>;
     static defaultProps: DefaultProps;
     state: State;
+    componentDidMount(): void;
     /**
      * @deprecated and likely very broken API
      * [LEMS-3185] do not trust serializedState
@@ -40,7 +42,7 @@ declare const _default: {
     name: string;
     displayName: string;
     hidden: true;
-    widget: typeof Categorizer;
+    widget: React.ForwardRefExoticComponent<Omit<Props, "dependencies"> & React.RefAttributes<any>>;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
     getCorrectUserInput: typeof getCorrectUserInput;
     getStartUserInput: typeof getStartUserInput;

package/dist/widgets/definition/definition.d.ts

@@ -1,26 +1,13 @@
 import * as React from "react";
-import { PerseusI18nContext } from "../../components/i18n-context";
-import type { Widget, WidgetProps } from "../../types";
-import type { DefinitionPromptJSON } from "../../widget-ai-utils/definition/definition-ai-utils";
+import type { PerseusDependenciesV2, WidgetProps } from "../../types";
 import type { PerseusDefinitionWidgetOptions, PerseusRenderer } from "@khanacademy/perseus-core";
 type DefinitionProps = WidgetProps<PerseusDefinitionWidgetOptions> & {
     widgets: PerseusRenderer["widgets"];
+    dependencies: PerseusDependenciesV2;
 };
-type DefaultProps = {
-    togglePrompt: string;
-    definition: string;
-};
-declare class Definition extends React.Component<DefinitionProps> implements Widget {
-    static contextType: React.Context<import("../../components/i18n-context").I18nContextType>;
-    context: React.ContextType<typeof PerseusI18nContext>;
-    static defaultProps: DefaultProps;
-    isWidget: true;
-    getPromptJSON(): DefinitionPromptJSON;
-    render(): React.ReactNode;
-}
 declare const _default: {
     name: string;
     displayName: string;
-    widget: typeof Definition;
+    widget: React.ForwardRefExoticComponent<Omit<DefinitionProps, "dependencies"> & React.RefAttributes<any>>;
 };
 export default _default;

package/dist/widgets/dropdown/dropdown.d.ts

@@ -1,30 +1,9 @@
 import * as React from "react";
-import { PerseusI18nContext } from "../../components/i18n-context";
-import type { Widget, WidgetProps } from "../../types";
-import type { DropdownPromptJSON } from "../../widget-ai-utils/dropdown/dropdown-ai-utils";
+import type { PerseusDependenciesV2, WidgetProps } from "../../types";
 import type { PerseusDropdownUserInput, PerseusDropdownWidgetOptions } from "@khanacademy/perseus-core";
-type Props = WidgetProps<PerseusDropdownWidgetOptions, PerseusDropdownUserInput>;
-type DefaultProps = {
-    choices: Props["choices"];
-    placeholder: Props["placeholder"];
-    apiOptions: Props["apiOptions"];
-    userInput: Props["userInput"];
+type Props = WidgetProps<PerseusDropdownWidgetOptions, PerseusDropdownUserInput> & {
+    dependencies: PerseusDependenciesV2;
 };
-declare class Dropdown extends React.Component<Props> implements Widget {
-    static contextType: React.Context<import("../../components/i18n-context").I18nContextType>;
-    context: React.ContextType<typeof PerseusI18nContext>;
-    static defaultProps: DefaultProps;
-    focus: () => boolean;
-    _handleChangeEvent: (arg1: React.ChangeEvent<HTMLInputElement>) => void;
-    _handleChange: (arg1: number) => void;
-    getPromptJSON(): DropdownPromptJSON;
-    /**
-     * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState
-     */
-    getSerializedState(): any;
-    render(): React.ReactNode;
-}
 /**
  * @deprecated and likely a very broken API
  * [LEMS-3185] do not trust serializedState
@@ -35,7 +14,7 @@ declare function getCorrectUserInput(options: PerseusDropdownWidgetOptions): Per
 declare const _default: {
     name: string;
     displayName: string;
-    widget: typeof Dropdown;
+    widget: React.ForwardRefExoticComponent<Omit<Props, "dependencies"> & React.RefAttributes<any>>;
     getStartUserInput: typeof getStartUserInput;
     getCorrectUserInput: typeof getCorrectUserInput;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;

package/dist/widgets/explanation/explanation.d.ts

@@ -1,36 +1,13 @@
 import * as React from "react";
-import { PerseusI18nContext } from "../../components/i18n-context";
-import type { Widget, WidgetProps } from "../../types";
-import type { ExplanationPromptJSON } from "../../widget-ai-utils/explanation/explanation-ai-utils";
+import type { PerseusDependenciesV2, WidgetProps } from "../../types";
 import type { PerseusExplanationWidgetOptions } from "@khanacademy/perseus-core";
-type Props = WidgetProps<PerseusExplanationWidgetOptions>;
-type DefaultProps = {
-    showPrompt: Props["showPrompt"];
-    hidePrompt: Props["hidePrompt"];
-    explanation: Props["explanation"];
-    widgets: Props["widgets"];
-    linterContext: Props["linterContext"];
+type Props = WidgetProps<PerseusExplanationWidgetOptions> & {
+    dependencies: PerseusDependenciesV2;
 };
-type State = {
-    expanded: boolean;
-};
-declare class Explanation extends React.Component<Props, State> implements Widget {
-    static contextType: React.Context<import("../../components/i18n-context").I18nContextType>;
-    context: React.ContextType<typeof PerseusI18nContext>;
-    static defaultProps: DefaultProps;
-    isWidget: true;
-    state: State;
-    _mounted: boolean;
-    componentDidMount(): void;
-    componentWillUnmount(): void;
-    _onClick: () => void;
-    getPromptJSON(): ExplanationPromptJSON;
-    render(): React.ReactNode;
-}
 declare const _default: {
     name: string;
     displayName: string;
-    widget: typeof Explanation;
+    widget: React.ForwardRefExoticComponent<Omit<Props, "dependencies"> & React.RefAttributes<any>>;
     isLintable: true;
 };
 export default _default;

package/dist/widgets/input-number/input-number.d.ts

@@ -1,7 +1,5 @@
 import * as React from "react";
-import { PerseusI18nContext } from "../../components/i18n-context";
-import type { Path, Widget, WidgetProps } from "../../types";
-import type { InputNumberPromptJSON } from "../../widget-ai-utils/input-number/input-number-ai-utils";
+import type { PerseusDependenciesV2, WidgetProps } from "../../types";
 import type { PerseusInputNumberWidgetOptions, PerseusInputNumberUserInput } from "@khanacademy/perseus-core";
 type ExternalProps = WidgetProps<PerseusInputNumberWidgetOptions, PerseusInputNumberUserInput>;
 type Props = ExternalProps & {
@@ -10,29 +8,8 @@ type Props = ExternalProps & {
     rightAlign: NonNullable<ExternalProps["rightAlign"]>;
     size: NonNullable<ExternalProps["size"]>;
     answerType: NonNullable<ExternalProps["answerType"]>;
+    dependencies: PerseusDependenciesV2;
 };
-type DefaultProps = Pick<Props, "answerType" | "apiOptions" | "linterContext" | "rightAlign" | "size" | "userInput">;
-declare class InputNumber extends React.Component<Props> implements Widget {
-    static contextType: React.Context<import("../../components/i18n-context").I18nContextType>;
-    context: React.ContextType<typeof PerseusI18nContext>;
-    static defaultProps: DefaultProps;
-    shouldShowExamples: () => boolean;
-    handleChange: (arg1: string, arg2: () => void) => void;
-    _handleFocus: () => void;
-    _handleBlur: () => void;
-    focus: () => boolean;
-    focusInputPath: (arg1: Path) => void;
-    blurInputPath: (arg1: Path) => void;
-    getInputPaths: () => ReadonlyArray<Path>;
-    getPromptJSON(): InputNumberPromptJSON;
-    examples(): ReadonlyArray<string>;
-    /**
-     * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState
-     */
-    getSerializedState(): any;
-    render(): React.ReactNode;
-}
 declare function getOneCorrectAnswerFromRubric(rubric: any): string | undefined;
 /**
  * @deprecated and likely a very broken API
@@ -45,7 +22,7 @@ declare const _default: {
     name: string;
     displayName: string;
     hidden: true;
-    widget: typeof InputNumber;
+    widget: React.ForwardRefExoticComponent<Omit<Props, "dependencies"> & React.RefAttributes<any>>;
     isLintable: true;
     getOneCorrectAnswerFromRubric: typeof getOneCorrectAnswerFromRubric;
     getStartUserInput: typeof getStartUserInput;

package/dist/widgets/matcher/matcher.d.ts

@@ -1,10 +1,12 @@
 import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { SortableOption } from "../../components/sortable";
-import type { WidgetProps, Widget } from "../../types";
+import type { WidgetProps, Widget, PerseusDependenciesV2 } from "../../types";
 import type { MatcherPromptJSON } from "../../widget-ai-utils/matcher/matcher-ai-utils";
 import type { PerseusMatcherWidgetOptions, PerseusMatcherUserInput, MatcherPublicWidgetOptions } from "@khanacademy/perseus-core";
-type Props = WidgetProps<PerseusMatcherWidgetOptions, PerseusMatcherUserInput>;
+type Props = WidgetProps<PerseusMatcherWidgetOptions, PerseusMatcherUserInput> & {
+    dependencies: PerseusDependenciesV2;
+};
 type DefaultProps = {
     labels: Props["labels"];
     orderMatters: Props["orderMatters"];
@@ -23,6 +25,7 @@ export declare class Matcher extends React.Component<Props, State> implements Wi
     context: React.ContextType<typeof PerseusI18nContext>;
     static defaultProps: DefaultProps;
     state: State;
+    componentDidMount(): void;
     changeAndTrack: () => void;
     onMeasureLeft: (arg1: any) => void;
     onMeasureRight: (arg1: any) => void;
@@ -41,7 +44,7 @@ declare function getUserInputFromSerializedState(serializedState: any): PerseusM
 declare const _default: {
     name: string;
     displayName: string;
-    widget: typeof Matcher;
+    widget: React.ForwardRefExoticComponent<Omit<Props, "dependencies"> & React.RefAttributes<any>>;
     isLintable: true;
     getStartUserInput: typeof getStartUserInput;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;

package/dist/widgets/number-line/number-line.d.ts

@@ -1,88 +1,12 @@
 import * as React from "react";
-import { PerseusI18nContext } from "../../components/i18n-context";
-import type { FocusPath, Widget, WidgetProps } from "../../types";
-import type { NumberLinePromptJSON } from "../../widget-ai-utils/number-line/number-line-ai-utils";
+import type { WidgetProps, PerseusDependenciesV2 } from "../../types";
 import type { PerseusNumberLineUserInput, PerseusNumberLineWidgetOptions, NumberLinePublicWidgetOptions } from "@khanacademy/perseus-core";
 /**
  * The type of `this.props` inside the NumberLine widget.
  */
-type Props = WidgetProps<PerseusNumberLineWidgetOptions, PerseusNumberLineUserInput>;
-type CalculatedProps = Props & {
-    tickStep: number;
+type Props = WidgetProps<PerseusNumberLineWidgetOptions, PerseusNumberLineUserInput> & {
+    dependencies: PerseusDependenciesV2;
 };
-type DefaultProps = {
-    range: Props["range"];
-    labelStyle: Props["labelStyle"];
-    labelRange: Props["labelRange"];
-    divisionRange: Props["divisionRange"];
-    labelTicks: Props["labelTicks"];
-    isTickCtrl: Props["isTickCtrl"];
-    isInequality: Props["isInequality"];
-    snapDivisions: Props["snapDivisions"];
-    showTooltips: Props["showTooltips"];
-    apiOptions: Props["apiOptions"];
-};
-type State = {
-    numDivisionsEmpty: boolean;
-};
-declare class NumberLine extends React.Component<Props, State> implements Widget {
-    static contextType: React.Context<import("../../components/i18n-context").I18nContextType>;
-    context: React.ContextType<typeof PerseusI18nContext>;
-    static defaultProps: DefaultProps;
-    state: any;
-    /**
-     * isTickCtrl seems like it can be null
-     * but default props only work with undefined,
-     * so this handles both null/undefined
-     */
-    getIsTickCtrl(): boolean;
-    /**
-     * snapDivisions seems like it can be null
-     * but default props only work with undefined,
-     * so this handles both null/undefined
-     */
-    getSnapDivisions(): number;
-    isValid: () => boolean;
-    onNumDivisionsChange: (arg1: number, arg2: any) => void;
-    _handleTickCtrlFocus: () => void;
-    _handleTickCtrlBlur: () => void;
-    focus(): boolean;
-    focusInputPath: (arg1: any) => void;
-    blurInputPath: (arg1: any) => void;
-    getInputPaths: () => ReadonlyArray<ReadonlyArray<string>>;
-    getDOMNodeForPath(inputPath: FocusPath): Element | Text | null;
-    _renderGraphie: () => React.ReactElement;
-    snapNumLinePosition: (arg1: any, arg2: number) => number;
-    movePosition: (arg1: number) => void;
-    _renderNumberLinePoint: (arg1: CalculatedProps) => React.ReactElement;
-    handleReverse: () => void;
-    handleToggleStrict: () => void;
-    _getInequalityEndpoint(props: CalculatedProps): [number, number];
-    _renderInequality(props: CalculatedProps): React.ReactElement | null;
-    _setupGraphie: (arg1: any, arg2: any) => void;
-    getPromptJSON(): NumberLinePromptJSON;
-    /**
-     * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState
-     */
-    getSerializedState(): {
-        alignment: string | null | undefined;
-        static: boolean;
-        range: number[];
-        labelRange: (number | null)[];
-        labelStyle: string;
-        labelTicks: boolean;
-        divisionRange: number[];
-        snapDivisions: number;
-        isInequality: boolean;
-        showTooltips: boolean | undefined;
-        isTickCtrl: boolean;
-        numDivisions: number;
-        numLinePosition: number;
-        rel: string;
-    };
-    render(): React.ReactNode;
-}
 /**
  * @deprecated and likely a very broken API
  * [LEMS-3185] do not trust serializedState
@@ -93,7 +17,7 @@ declare function getStartUserInput(options: NumberLinePublicWidgetOptions): Pers
 declare const _default: {
     name: string;
     displayName: string;
-    widget: typeof NumberLine;
+    widget: React.ForwardRefExoticComponent<Omit<Props, "dependencies"> & React.RefAttributes<any>>;
     getCorrectUserInput: typeof getCorrectUserInput;
     getStartUserInput: typeof getStartUserInput;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;

package/dist/widgets/sorter/sorter.d.ts

@@ -1,37 +1,9 @@
 import * as React from "react";
-import type { SortableOption } from "../../components/sortable";
-import type { Widget, WidgetProps } from "../../types";
-import type { SorterPromptJSON } from "../../widget-ai-utils/sorter/sorter-ai-utils";
+import type { PerseusDependenciesV2, WidgetProps } from "../../types";
 import type { PerseusSorterWidgetOptions, PerseusSorterUserInput, SorterPublicWidgetOptions } from "@khanacademy/perseus-core";
-type Props = WidgetProps<PerseusSorterWidgetOptions, PerseusSorterUserInput>;
-type DefaultProps = {
-    correct: Props["correct"];
-    layout: Props["layout"];
-    padding: Props["padding"];
-    problemNum: Props["problemNum"];
-    linterContext: Props["linterContext"];
+type Props = WidgetProps<PerseusSorterWidgetOptions, PerseusSorterUserInput> & {
+    dependencies: PerseusDependenciesV2;
 };
-declare class Sorter extends React.Component<Props> implements Widget {
-    _isMounted: boolean;
-    static defaultProps: DefaultProps;
-    componentDidMount(): void;
-    componentWillUnmount(): void;
-    handleChange: (arg1: React.ChangeEvent<HTMLInputElement>) => void;
-    /**
-     * This is kind of a problem. Sortable maintains an internal state
-     * but we also want the user input state to include the same state.
-     * This is to help keep the two in sync for now.
-     */
-    _getOptionsFromSortable(): string[];
-    getPromptJSON(): SorterPromptJSON;
-    moveOptionToIndex: (option: SortableOption, index: number) => void;
-    /**
-     * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState
-     */
-    getSerializedState(): any;
-    render(): React.ReactNode;
-}
 declare function getStartUserInput(options: SorterPublicWidgetOptions, problemNum: number): PerseusSorterUserInput;
 /**
  * @deprecated and likely a very broken API
@@ -41,7 +13,7 @@ declare function getUserInputFromSerializedState(serializedState: any): PerseusS
 declare const _default: {
     name: string;
     displayName: string;
-    widget: typeof Sorter;
+    widget: React.ForwardRefExoticComponent<Omit<Props, "dependencies"> & React.RefAttributes<any>>;
     isLintable: true;
     getStartUserInput: typeof getStartUserInput;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;

package/package.json

@@ -3,7 +3,7 @@
   "description": "Core Perseus API (includes renderers and widgets)",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "72.0.0",
+  "version": "72.1.0",
   "publishConfig": {
     "access": "public"
   },
@@ -41,16 +41,16 @@
     "mafs": "0.19.0",
     "tiny-invariant": "1.3.1",
     "uuid": "^10.0.0",
-    "@khanacademy/kas": "2.1.3",
-    "@khanacademy/keypad-context": "3.2.15",
-    "@khanacademy/kmath": "2.2.15",
-    "@khanacademy/perseus-core": "20.1.3",
-    "@khanacademy/math-input": "26.2.17",
-    "@khanacademy/perseus-linter": "4.4.5",
-    "@khanacademy/perseus-score": "8.0.4",
-    "@khanacademy/perseus-utils": "2.1.1",
-    "@khanacademy/pure-markdown": "2.2.1",
-    "@khanacademy/simple-markdown": "2.1.1"
+    "@khanacademy/kas": "2.1.4",
+    "@khanacademy/keypad-context": "3.2.16",
+    "@khanacademy/kmath": "2.2.16",
+    "@khanacademy/math-input": "26.2.18",
+    "@khanacademy/perseus-core": "20.1.4",
+    "@khanacademy/perseus-linter": "4.4.6",
+    "@khanacademy/perseus-score": "8.0.5",
+    "@khanacademy/perseus-utils": "2.1.2",
+    "@khanacademy/pure-markdown": "2.2.2",
+    "@khanacademy/simple-markdown": "2.1.2"
   },
   "devDependencies": {
     "@khanacademy/wonder-blocks-announcer": "1.0.4",