@khanacademy/perseus 21.6.0 → 22.0.0

package/dist/article-renderer.d.ts

@@ -3,6 +3,7 @@
  * composed of multiple (Renderer) sections concatenated together.
  */
 import * as React from "react";
+import { PerseusI18nContext } from "./components/i18n-context";
 import { DependenciesContext } from "./dependencies";
 import Renderer from "./renderer";
 import type { PerseusRenderer } from "./perseus-types";
@@ -28,6 +29,11 @@ type DefaultProps = {
     linterContext: Props["linterContext"];
 };
 declare class ArticleRenderer extends React.Component<Props> implements KeypadContextRendererInterface {
+    static contextType: React.Context<{
+        strings: import("./strings").PerseusStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof PerseusI18nContext>;
     _currentFocus: any;
     sectionRenderers: Array<Renderer>;
     static defaultProps: DefaultProps;

package/dist/components/highlighting/ui/highlight-set-renderer.d.ts

@@ -1,4 +1,13 @@
+/**
+ * Render a set of highlights. See HighlightRenderer for more details about how
+ * each highlight is rendered.
+ *
+ * This component manages the state of the "Remove highlight" tooltip. To
+ * determine the currently-hovered highlight, it calls the `isHovered` method
+ * on each HighlightRenderer.
+ */
 import * as React from "react";
+import { PerseusI18nContext } from "../../i18n-context";
 import HighlightRenderer from "./highlight-renderer";
 import type { DOMHighlightSet, Position, ZIndexes } from "./types";
 type Props = {
@@ -13,6 +22,11 @@ type State = {
     hoveringTooltipFor: string | null | undefined;
 };
 declare class HighlightSetRenderer extends React.PureComponent<Props, State> {
+    static contextType: React.Context<{
+        strings: import("../../../strings").PerseusStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof PerseusI18nContext>;
     state: State;
     _highlightRenderers: {
         [highlightKey: string]: HighlightRenderer;

package/dist/components/highlighting/ui/highlighting-ui.d.ts

@@ -1,4 +1,16 @@
+/**
+ * This component, given a set of DOMHighlights, draws highlight rectangles in
+ * the same absolute position as the highlighted content, as computed by the
+ * range's `getClientRects` method.
+ *
+ * TODO(mdr): Many things can affect the correct positioning of highlighting,
+ *     and this component does not attempt to anticipate them. If we start
+ *     using this highlighting library on content with a more dynamic layout,
+ *     we should add a hook to allow the parent to `forceUpdate` the
+ *     `HighlightingUI`.
+ */
 import * as React from "react";
+import { PerseusI18nContext } from "../../i18n-context";
 import type { TrackedSelection } from "./selection-tracker";
 import type { DOMHighlight, DOMHighlightSet, DOMRange, ZIndexes } from "./types";
 type Props = {
@@ -12,6 +24,11 @@ type Props = {
     zIndexes: ZIndexes;
 };
 declare class HighlightingUI extends React.PureComponent<Props> {
+    static contextType: React.Context<{
+        strings: import("../../../strings").PerseusStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof PerseusI18nContext>;
     _handleAddHighlight(highlightToAdd: DOMHighlight): void;
     _selectionIsValid(trackedSelection?: TrackedSelection | null): trackedSelection is TrackedSelection;
     render(): React.ReactNode;

package/dist/components/i18n-context.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PerseusI18nContext provides a way to set the strings and locale that are
+ * used inside the Perseus package.
+ *
+ */
+import * as React from "react";
+import type { PerseusStrings } from "../strings";
+type I18nContextType = {
+    strings: PerseusStrings;
+    locale: string;
+};
+export declare const PerseusI18nContext: React.Context<I18nContextType>;
+type Props = React.PropsWithChildren<I18nContextType>;
+export declare function PerseusI18nContextProvider({ children, strings, locale }: Props): JSX.Element;
+export declare const usePerseusI18n: () => I18nContextType;
+export {};

package/dist/components/input-with-examples.d.ts

@@ -1,4 +1,5 @@
 import * as React from "react";
+import { PerseusI18nContext } from "./i18n-context";
 import type { LinterContextProps } from "@khanacademy/perseus-linter";
 import type { StyleType } from "@khanacademy/wonder-blocks-core";
 type Props = {
@@ -33,6 +34,11 @@ type State = {
     showExamples: boolean;
 };
 declare class InputWithExamples extends React.Component<Props, State> {
+    static contextType: React.Context<{
+        strings: import("../strings").PerseusStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof PerseusI18nContext>;
     static defaultProps: DefaultProps;
     state: State;
     _getUniqueId: () => string;

package/dist/components/math-input.d.ts

@@ -1,5 +1,6 @@
-import { CursorContext } from "@khanacademy/math-input";
+import { CursorContext, MathInputI18nContext } from "@khanacademy/math-input";
 import * as React from "react";
+import { PerseusI18nContext } from "./i18n-context";
 import type { LegacyButtonSets } from "../perseus-types";
 import type { PerseusDependenciesV2 } from "../types";
 import type { Keys, MathFieldInterface } from "@khanacademy/math-input";
@@ -41,6 +42,9 @@ type Props = {
     buttonsVisible?: ButtonsVisibleType;
     analytics: PerseusDependenciesV2["analytics"];
 };
+type InnerProps = Props & {
+    mathInputStrings: any;
+};
 type DefaultProps = {
     value: Props["value"];
     convertDotToTimes: Props["convertDotToTimes"];
@@ -51,7 +55,12 @@ type State = {
     cursorContext: (typeof CursorContext)[keyof typeof CursorContext];
     openedWithEventType?: string;
 };
-declare class MathInput extends React.Component<Props, State> {
+declare class InnerMathInput extends React.Component<InnerProps, State> {
+    static contextType: React.Context<{
+        strings: import("../strings").PerseusStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof PerseusI18nContext>;
     mouseDown: boolean;
     __mathFieldWrapperRef: HTMLSpanElement | null;
     __mathField: MathFieldInterface | null;
@@ -67,4 +76,15 @@ declare class MathInput extends React.Component<Props, State> {
     handleKeypadPress: (key: Keys, e: any) => void;
     render(): React.ReactNode;
 }
+declare class MathInput extends React.Component<Props, State> {
+    static contextType: React.Context<{
+        strings: import("../../../math-input/src/strings").MathInputStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof MathInputI18nContext>;
+    inputRef: React.RefObject<InnerMathInput>;
+    focus(): void;
+    insert(value: any): void;
+    render(): JSX.Element;
+}
 export default MathInput;

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

@@ -1,7 +1,13 @@
 import PropTypes from "prop-types";
 import * as React from "react";
+import { PerseusI18nContext } from "./i18n-context";
 import type { MathFormat } from "../perseus-types";
 declare class NumberInput extends React.Component<any, any> {
+    static contextType: React.Context<{
+        strings: import("../strings").PerseusStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof PerseusI18nContext>;
     static propTypes: {
         value: PropTypes.Requireable<number>;
         format: PropTypes.Requireable<string>;