@khanacademy/perseus 21.5.0 → 22.0.0

package/dist/multi-items/multi-renderer.d.ts

@@ -1,4 +1,5 @@
 import * as React from "react";
+import { PerseusI18nContext } from "../components/i18n-context";
 import Renderer from "../renderer";
 import type { Item, ContentNode, HintNode, TagsNode } from "./item-types";
 import type { Shape, ArrayShape } from "./shape-types";
@@ -55,6 +56,11 @@ type State = {
     renderError: Error | null | undefined;
 };
 declare class MultiRenderer extends React.Component<Props, State> {
+    static contextType: React.Context<{
+        strings: import("../strings").PerseusStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof PerseusI18nContext>;
     rendererDataTreeMapper: TreeMapper<ContentNode, ContentRendererData, HintNode, HintRendererData, TagsNode, null>;
     getRenderersMapper: TreeMapper<ContentRendererData, ContentRendererElement, HintRendererData, HintRendererElement, null, null>;
     constructor(props: Props);

package/dist/perseus-api.d.ts

@@ -96,13 +96,15 @@ export declare const ApiOptions: {
         crossOutEnabled?: boolean | undefined;
         editorChangeDelay?: number | undefined;
         flags?: {
-            mafs?: false | {
+            mafs?: false | ({
                 polygon?: boolean | undefined;
                 linear?: boolean | undefined;
+                ray?: boolean | undefined;
                 segment?: boolean | undefined;
                 "linear-system"?: boolean | undefined;
-                ray?: boolean | undefined;
-            } | undefined;
+            } & {
+                "interactive-graph-locked-features-m1"?: boolean | undefined;
+            }) | undefined;
         } | undefined;
         onWidgetStartProps?: ((widgets: import("./perseus-types").PerseusWidgetsMap) => void) | undefined;
     }> & {

package/dist/perseus-types.d.ts

@@ -4,10 +4,6 @@ export type Range = Interval;
 export type Size = [number, number];
 export type CollinearTuple = readonly [vec.Vector2, vec.Vector2];
 export type ShowSolutions = "all" | "selected" | "none";
-export type StyleParams = {
-    fill?: string;
-    stroke?: string;
-};
 type Empty = Record<never, never>;
 export type PerseusWidgetsMap = {
     [key in `categorizer ${number}`]: CategorizerWidget;
@@ -351,12 +347,26 @@ export type PerseusInteractiveGraphWidgetOptions = {
     correct: PerseusGraphType;
     lockedFigures?: ReadonlyArray<LockedFigure>;
 };
-export type LockedFigure = LockedPoint;
-export type LockedFigureType = "point";
-export type LockedPoint = {
+declare const lockedFigureColorNames: readonly ["blue", "green", "gray", "grayH", "grayI", "purple", "purpleD", "pink", "orange", "red"];
+export type LockedFigureColor = (typeof lockedFigureColorNames)[number];
+export declare const lockedFigureColors: Record<LockedFigureColor, string>;
+export type LockedFigure = LockedPointType | LockedLineType;
+export type LockedFigureType = LockedFigure["type"];
+export type LockedPointType = {
     type: "point";
     coord: Coord;
-    style?: StyleParams;
+    color: LockedFigureColor;
+    filled: boolean;
+};
+export type LockedLineType = {
+    type: "line";
+    kind: "line" | "ray" | "segment";
+    points: [startPoint: LockedPointType, endPoint: LockedPointType];
+    color: LockedFigureColor;
+    lineStyle: "solid" | "dashed";
+    showArrows: boolean;
+    showStartPoint: boolean;
+    showEndPoint: boolean;
 };
 export type PerseusGraphType = PerseusGraphTypeAngle | PerseusGraphTypeCircle | PerseusGraphTypeLinear | PerseusGraphTypeLinearSystem | PerseusGraphTypePoint | PerseusGraphTypePolygon | PerseusGraphTypeQuadratic | PerseusGraphTypeRay | PerseusGraphTypeSegment | PerseusGraphTypeSinusoid;
 export type PerseusGraphTypeCommon = {

package/dist/renderer.d.ts

@@ -4,6 +4,7 @@ import TranslationLinter from "./translation-linter";
 import WidgetContainer from "./widget-container";
 import type { DependenciesContext } from "./dependencies";
 import type { PerseusRenderer, PerseusWidget, PerseusWidgetOptions, PerseusWidgetsMap, ShowSolutions } from "./perseus-types";
+import type { PerseusStrings } from "./strings";
 import type { APIOptions, APIOptionsWithDefaults, FilterCriterion, FocusPath, PerseusScore, WidgetProps } from "./types";
 import type { LinterContextProps } from "@khanacademy/perseus-linter";
 import "./styles/perseus-renderer.less";
@@ -86,6 +87,7 @@ type Props = Partial<React.ContextType<typeof DependenciesContext>> & {
      *  Skip adding paragraph class
      */
     inline?: boolean;
+    strings: PerseusStrings;
 };
 type State = {
     translationLintErrors: ReadonlyArray<string>;

package/dist/server-item-renderer.d.ts

@@ -8,6 +8,7 @@ import * as PerseusLinter from "@khanacademy/perseus-linter";
  * This component is compatible with server-rendering of a perseus exercise.
  */
 import * as React from "react";
+import { PerseusI18nContext } from "./components/i18n-context";
 import Renderer from "./renderer";
 import type { PerseusItem, ShowSolutions } from "./perseus-types";
 import type { APIOptions, FocusPath, PerseusDependenciesV2 } from "./types";
@@ -42,6 +43,11 @@ type SerializedState = {
     hints: any;
 };
 export declare class ServerItemRenderer extends React.Component<Props, State> implements RendererInterface, KeypadContextRendererInterface {
+    static contextType: React.Context<{
+        strings: import("./strings").PerseusStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof PerseusI18nContext>;
     questionRenderer: Renderer;
     hintsRenderer: any;
     _currentFocus: FocusPath;
@@ -135,13 +141,15 @@ declare const ref: React.ForwardRefExoticComponent<Omit<Pick<OwnProps & HOCProps
         crossOutEnabled?: boolean | undefined;
         editorChangeDelay?: number | undefined;
         flags?: {
-            mafs?: false | {
+            mafs?: false | ({
                 polygon?: boolean | undefined;
                 linear?: boolean | undefined;
+                ray?: boolean | undefined;
                 segment?: boolean | undefined;
                 "linear-system"?: boolean | undefined;
-                ray?: boolean | undefined;
-            } | undefined;
+            } & {
+                "interactive-graph-locked-features-m1"?: boolean | undefined;
+            }) | undefined;
         } | undefined;
         onWidgetStartProps?: ((widgets: import("./perseus-types").PerseusWidgetsMap) => void) | undefined;
     }> | undefined;

package/dist/strings.d.ts

@@ -0,0 +1,190 @@
+/**
+ * The translated strings that are used to render Perseus.
+ */
+export type PerseusStrings = {
+    closeKeypad: string;
+    openKeypad: string;
+    removeHighlight: string;
+    addHighlight: string;
+    hintPos: ({ pos }: {
+        pos: number;
+    }) => string;
+    errorRendering: ({ error }: {
+        error: string;
+    }) => string;
+    APPROXIMATED_PI_ERROR: string;
+    EXTRA_SYMBOLS_ERROR: string;
+    NEEDS_TO_BE_SIMPLFIED_ERROR: string;
+    MISSING_PERCENT_ERROR: string;
+    MULTIPLICATION_SIGN_ERROR: string;
+    WRONG_CASE_ERROR: string;
+    WRONG_LETTER_ERROR: string;
+    invalidSelection: string;
+    ERROR_TITLE: string;
+    ERROR_MESSAGE: string;
+    hints: string;
+    getAnotherHint: string;
+    deprecatedStandin: string;
+    keepTrying: string;
+    tryAgain: string;
+    check: string;
+    correctExcited: string;
+    nextQuestion: string;
+    skipToTitle: ({ title }: {
+        title: string;
+    }) => string;
+    current: string;
+    correct: string;
+    correctSelected: string;
+    correctCrossedOut: string;
+    incorrect: string;
+    incorrectSelected: string;
+    hideExplanation: string;
+    explain: string;
+    INVALID_MESSAGE_PREFIX: string;
+    DEFAULT_INVALID_MESSAGE_1: string;
+    DEFAULT_INVALID_MESSAGE_2: string;
+    integerExample: string;
+    properExample: string;
+    simplifiedProperExample: string;
+    improperExample: string;
+    simplifiedImproperExample: string;
+    mixedExample: string;
+    decimalExample: string;
+    percentExample: string;
+    piExample: string;
+    yourAnswer: string;
+    yourAnswerLabel: string;
+    addPoints: string;
+    addVertices: string;
+    tapMultiple: string;
+    tapSingle: string;
+    clickMultiple: string;
+    clickSingle: string;
+    choices: string;
+    answers: ({ num }: {
+        num: number;
+    }) => string;
+    hideAnswersToggleLabel: string;
+    moves: ({ num }: {
+        num: number;
+    }) => string;
+    clickTiles: string;
+    turnOffLights: string;
+    fillAllCells: string;
+    molecularDrawing: ({ content }: {
+        content: string;
+    }) => string;
+    switchDirection: string;
+    circleOpen: string;
+    circleFilled: string;
+    numDivisions: string;
+    divisions: ({ divRangeString }: {
+        divRangeString: string;
+    }) => string;
+    lineRange: ({ lineRange }: {
+        lineRange: string;
+    }) => string;
+    lineNumber: ({ lineNumber }: {
+        lineNumber: string;
+    }) => string;
+    symbolPassage: ({ questionSymbol, questionNumber, }: {
+        questionSymbol: string;
+        questionNumber: string;
+    }) => string;
+    symbolQuestion: ({ sentenceSymbol }: {
+        sentenceSymbol: string;
+    }) => string;
+    lineLabel: string;
+    beginningPassage: string;
+    beginningFootnotes: string;
+    endPassage: string;
+    questionMarker: ({ number }: {
+        number: string;
+    }) => string;
+    circleMarker: ({ number }: {
+        number: string;
+    }) => string;
+    sentenceMarker: ({ number }: {
+        number: string;
+    }) => string;
+    dragHandles: string;
+    tapAddPoints: string;
+    false: string;
+    true: string;
+    no: string;
+    yes: string;
+    chooseCorrectNum: string;
+    notNoneOfTheAbove: string;
+    noneOfTheAbove: string;
+    chooseNumAnswers: ({ numCorrect }: {
+        numCorrect: string;
+    }) => string;
+    chooseAllAnswers: string;
+    chooseOneAnswer: string;
+    choiceCheckedCorrect: ({ letter }: {
+        letter: string;
+    }) => string;
+    choiceCrossedOutCorrect: ({ letter }: {
+        letter: string;
+    }) => string;
+    choiceCorrect: ({ letter }: {
+        letter: string;
+    }) => string;
+    choiceCheckedIncorrect: ({ letter }: {
+        letter: string;
+    }) => string;
+    choiceCrossedOutIncorrect: ({ letter }: {
+        letter: string;
+    }) => string;
+    choiceIncorrect: ({ letter }: {
+        letter: string;
+    }) => string;
+    choiceChecked: ({ letter }: {
+        letter: string;
+    }) => string;
+    choiceCrossedOut: ({ letter }: {
+        letter: string;
+    }) => string;
+    choice: ({ letter }: {
+        letter: string;
+    }) => string;
+    crossOut: string;
+    crossOutOption: string;
+    crossOutChoice: ({ letter }: {
+        letter: string;
+    }) => string;
+    bringBack: string;
+    openMenuForChoice: ({ letter }: {
+        letter: string;
+    }) => string;
+    letters: string;
+    rightArrow: string;
+    dontUnderstandUnits: string;
+    checkSigFigs: string;
+    answerNumericallyIncorrect: string;
+    checkUnits: string;
+    dontUnderstand: string;
+    loading: string;
+    videoTranscript: string;
+    somethingWrong: string;
+    videoWrapper: string;
+};
+/**
+ * Untranslated strings used in Perseus. To be used by an external
+ * translator to produce translated strings, passed in as `PerseusStrings`.
+ */
+export declare const strings: {
+    [key in keyof PerseusStrings]: string | {
+        context?: string;
+        message: string;
+    } | {
+        context?: string;
+        one: string;
+        other: string;
+    };
+};
+/**
+ * Mock strings for the Perseus package, to be used for tests and Storybook.
+ */
+export declare const mockStrings: PerseusStrings;