@khanacademy/perseus 3.0.0 → 4.0.0

package/dist/question-paragraph.d.ts

@@ -0,0 +1,11 @@
+import * as React from "react";
+type Props = {
+    className?: string | null | undefined;
+    translationIndex: number;
+    paragraphIndex?: number;
+    children?: React.ReactNode;
+};
+declare class QuestionParagraph extends React.Component<Props> {
+    render(): React.ReactNode;
+}
+export default QuestionParagraph;

package/dist/question-paragraph.js.flow

@@ -0,0 +1,17 @@
+/**
+ * Flowtype definitions for data
+ * Generated by Flowgen from a Typescript Definition
+ * Flowgen v1.21.0
+ * @flow
+ */
+import * as React from "react";
+declare type Props = {|
+  className?: string | null | void,
+  translationIndex: number,
+  paragraphIndex?: number,
+  children?: React.Node,
+|};
+declare class QuestionParagraph extends React.Component<Props> {
+  render(): React.Node;
+}
+declare export default typeof QuestionParagraph;

package/dist/renderability.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Calculates whether a perseus item is renderable by a specific
+ * perseus-item-data version.
+ *
+ * This is done inside of the perseus repo so that it can traverse
+ * widget-specific data that might need to do a sub-traversal.
+ * This supports widgets that contain renderers, such as the
+ * group or sequence widgets.
+ */
+export declare const isItemRenderableByVersion: (itemData: any, rendererContentVersion: any) => boolean;

package/dist/renderability.js.flow

@@ -0,0 +1,19 @@
+/**
+ * Flowtype definitions for data
+ * Generated by Flowgen from a Typescript Definition
+ * Flowgen v1.21.0
+ * @flow
+ */
+/**
+ * Calculates whether a perseus item is renderable by a specific
+ * perseus-item-data version.
+ *
+ * This is done inside of the perseus repo so that it can traverse
+ * widget-specific data that might need to do a sub-traversal.
+ * This supports widgets that contain renderers, such as the
+ * group or sequence widgets.
+ */
+declare export var isItemRenderableByVersion: (
+  itemData: any,
+  rendererContentVersion: any
+) => boolean;

package/dist/renderer.d.ts

@@ -0,0 +1,254 @@
+import * as React from "react";
+import InteractionTracker from "./interaction-tracker";
+import TranslationLinter from "./translation-linter";
+import type { PerseusRenderer, PerseusWidgetOptions } from "./perseus-types";
+import type { APIOptions, APIOptionsWithDefaults, FilterCriterion, FocusPath, LinterContextProps, PerseusDependencies, PerseusScore, WidgetInfo, WidgetProps } from "./types";
+import "./styles/perseus-renderer.less";
+type WidgetState = {
+    isMobile?: boolean;
+    inTable?: boolean;
+    key?: number;
+    paragraphIndex?: number;
+    foundFullWidth?: boolean;
+    baseElements?: any;
+};
+type SetWidgetPropsFn = (id: string, newProps: any, cb: () => boolean, silent?: boolean) => void;
+type WidgetUserInput = any;
+type SerializedState = {
+    [id: string]: any;
+};
+export type Widget = {
+    focus: () => {
+        id: string;
+        path: FocusPath;
+    } | boolean;
+    getDOMNodeForPath: (path: FocusPath) => Element | Text | null;
+    deselectIncorrectSelectedChoices?: () => void;
+    restoreSerializedState: (props: any, callback: () => void) => any;
+    getSerializedState?: () => SerializedState;
+    getGrammarTypeForPath: (path: FocusPath) => string;
+    blurInputPath?: (path: FocusPath) => null;
+    focusInputPath?: (path: FocusPath) => null;
+    getInputPaths?: () => ReadonlyArray<FocusPath>;
+    setInputValue?: (path: FocusPath, newValue: string, focus: () => unknown) => void;
+    getUserInput?: () => WidgetUserInput | null | undefined;
+    simpleValidate?: (options?: any, onOutputError?: (widgetId: any, value: string, message?: string | null | undefined) => unknown | null | undefined) => PerseusScore;
+    showRationalesForCurrentlySelectedChoices?: (options?: any) => void;
+    examples?: () => ReadonlyArray<string>;
+};
+type Props = {
+    apiOptions?: APIOptions;
+    alwaysUpdate?: boolean;
+    findExternalWidgets: any;
+    highlightedWidgets?: ReadonlyArray<any>;
+    images: PerseusRenderer["images"];
+    keypadElement?: any;
+    onInteractWithWidget: (id: string) => void;
+    onRender: (node?: any) => void;
+    problemNum?: number;
+    questionCompleted?: boolean;
+    reviewMode?: boolean | null | undefined;
+    content: PerseusRenderer["content"];
+    serializedState?: any;
+    onSerializedStateUpdated: (serializedState: {
+        [key: string]: any;
+    }) => unknown;
+    linterContext: LinterContextProps;
+    legacyPerseusLint?: ReadonlyArray<string>;
+    widgets: PerseusRenderer["widgets"];
+};
+type State = {
+    translationLintErrors: ReadonlyArray<string>;
+    widgetInfo: Readonly<{
+        [id: string]: WidgetInfo | null | undefined;
+    }>;
+    widgetProps: Readonly<{
+        [id: string]: any | null | undefined;
+    }>;
+    jiptContent: any;
+    lastUsedWidgetId: string | null | undefined;
+};
+type Context = LinterContextProps & {
+    content: string;
+    widgets: {
+        [id: string]: any;
+    };
+};
+type DefaultProps = {
+    alwaysUpdate: Props["alwaysUpdate"];
+    content: Props["content"];
+    findExternalWidgets: Props["findExternalWidgets"];
+    highlightedWidgets: Props["highlightedWidgets"];
+    images: Props["images"];
+    linterContext: Props["linterContext"];
+    onInteractWithWidget: Props["onInteractWithWidget"];
+    onRender: Props["onRender"];
+    onSerializedStateUpdated: Props["onSerializedStateUpdated"];
+    questionCompleted: Props["questionCompleted"];
+    reviewMode: Props["reviewMode"];
+    serializedState: Props["serializedState"];
+    widgets: Props["widgets"];
+};
+declare class Renderer extends React.Component<Props, State> {
+    _currentFocus: FocusPath | null | undefined;
+    _foundTextNodes: boolean;
+    _interactionTrackers: {
+        [id: string]: InteractionTracker;
+    };
+    _isMounted: boolean;
+    _isTwoColumn: boolean;
+    _translationLinter: TranslationLinter;
+    lastRenderedMarkdown: React.ReactElement<React.ComponentProps<PerseusDependencies["KatexProvider"]>>;
+    reuseMarkdown: boolean;
+    translationIndex: number;
+    widgetIds: Array<string>;
+    static defaultProps: DefaultProps;
+    constructor(props: Props, context: Context);
+    componentDidMount(): void;
+    UNSAFE_componentWillReceiveProps(nextProps: Props): void;
+    shouldComponentUpdate(nextProps: Props, nextState: State): any | boolean;
+    UNSAFE_componentWillUpdate(nextProps: Props, nextState: State): void;
+    componentDidUpdate(prevProps: Props, prevState: State): void;
+    componentWillUnmount(): void;
+    getApiOptions: () => APIOptionsWithDefaults;
+    _getInitialWidgetState: (props: Props) => {
+        widgetInfo: State["widgetInfo"];
+        widgetProps: State["widgetProps"];
+    };
+    _getAllWidgetsInfo: (props: Props) => {
+        [key: string]: WidgetInfo;
+    };
+    _getAllWidgetsStartProps: (allWidgetInfo: {
+        [key: string]: WidgetInfo;
+    }, props: Props) => any;
+    _getDefaultWidgetInfo: (widgetId: string) => any;
+    _getWidgetInfo: (widgetId: string) => WidgetInfo;
+    renderWidget: (impliedType: string, id: string, state: WidgetState) => null | React.ReactNode;
+    getWidgetProps: (id: string) => WidgetProps<any, PerseusWidgetOptions>;
+    /**
+     * Serializes the questions state so it can be recovered.
+     *
+     * The return value of this function can be sent to the
+     * `restoreSerializedState` method to restore this state.
+     *
+     * If an instance of widgetProps is passed in, it generates the serialized
+     * state from that instead of the current widget props.
+     */
+    getSerializedState: (widgetProps?: any) => {
+        [id: string]: any;
+    };
+    restoreSerializedState: (serializedState: SerializedState, callback?: () => void) => void;
+    /**
+     * Tell each of the radio widgets to show rationales for each of the
+     * currently selected choices inside of them. If the widget is correct, it
+     * shows rationales for all of the choices. This also disables interaction
+     * with the choices that we show rationales for.
+     */
+    showRationalesForCurrentlySelectedChoices: () => void;
+    /**
+     * Tells each of the radio widgets to deselect any of the incorrect choices
+     * that are currently selected (leaving correct choices still selected).
+     */
+    deselectIncorrectSelectedChoices: () => void;
+    /**
+     * Allows inter-widget communication.
+     *
+     * This function yields this Renderer's own internal widgets, and it's used
+     * in two places.
+     *
+     * First, we expose our own internal widgets to each other by giving them
+     * a `findWidgets` function that, in turn, calls this function.
+     *
+     * Second, we expose our own internal widgets to this Renderer's parent,
+     * by allowing it to call this function directly. That way, it can hook us
+     * up to other Renderers on the page, by writing a `findExternalWidgets`
+     * prop that calls each other Renderer's `findInternalWidgets` function.
+     *
+     * Takes a `filterCriterion` on which widgets to return.
+     * `filterCriterion` can be one of:
+     *  * A string widget id
+     *  * A string widget type
+     *  * a function from (id, widgetInfo, widgetComponent) to true or false
+     *
+     * Returns an array of the matching widget components.
+     *
+     * If you need to do logic with more than the components, it is possible
+     * to do such logic inside the filter, rather than on the result array.
+     *
+     * See the passage-ref widget for an example.
+     *
+     * "Remember: abilities are not inherently good or evil, it's how you use
+     * them." ~ Kyle Katarn
+     * Please use this one with caution.
+     */
+    findInternalWidgets: (filterCriterion: FilterCriterion) => ReadonlyArray<Widget | null | undefined>;
+    /**
+     * Allows inter-widget communication.
+     *
+     * Includes both widgets internal to this Renderer, and external widgets
+     * exposed by the `findExternalWidgets` prop.
+     *
+     * See `findInteralWidgets` for more information.
+     */
+    findWidgets: (filterCriterion: FilterCriterion) => any;
+    getWidgetInstance: (id: string) => Widget | null | undefined;
+    _onWidgetFocus: (id: string, focusPath?: ReadonlyArray<string>) => void;
+    _onWidgetBlur: (id: string, blurPath: FocusPath) => void;
+    getContent: (props: Props, state: State) => any;
+    shouldRenderJiptPlaceholder: (props: Props, state: State) => boolean;
+    replaceJiptContent: (content: string, paragraphIndex: number) => void;
+    outputMarkdown: (ast: any, state: WidgetState) => React.ReactElement;
+    outputNested: (ast: any, state: WidgetState) => React.ReactElement;
+    outputNode: (node: any, nestedOutput: any, state: WidgetState) => any | null | React.ReactElement<React.ComponentProps<"div">> | React.ReactElement<React.ComponentProps<"span">> | React.ReactNode;
+    handleRender: (prevProps: Props) => void;
+    _setCurrentFocus: (path: FocusPath) => void;
+    focus: () => boolean | null | undefined;
+    getDOMNodeForPath: (path: FocusPath) => Element | Text | null | undefined;
+    getGrammarTypeForPath: (path: FocusPath) => string | null | undefined;
+    getInputPaths: () => ReadonlyArray<FocusPath>;
+    focusPath: (path: FocusPath) => void;
+    blurPath: (path: FocusPath) => void;
+    blur: () => void;
+    serialize: () => Record<any, any>;
+    emptyWidgets: () => any;
+    _setWidgetProps: SetWidgetPropsFn;
+    setInputValue: (path: FocusPath, newValue: string, focus: () => unknown) => void;
+    /**
+     * Returns an array of the widget `.getUserInput()` results
+     */
+    getUserInput: () => ReadonlyArray<WidgetUserInput | null | undefined>;
+    /**
+     * Returns an array of all widget IDs in the order they occur in
+     * the content.
+     */
+    getWidgetIds: () => ReadonlyArray<string>;
+    /**
+     * Returns the result of `.getUserInput()` for each widget, in
+     * a map from widgetId to userInput.
+     * NOTE(jeremy): This function is hauntingly similar to `getUserInput` with
+     * the major difference being that this function returns a map of
+     * `widgetID` => UserInput and `getUserInput` simply returns an array. It
+     * would be trivial to map between the results of each of these functions,
+     * so we should aim to remove one of these functions.
+     */
+    getUserInputForWidgets: () => {
+        [widgetId: string]: WidgetUserInput | null | undefined;
+    };
+    /**
+     * Returns an object mapping from widget ID to perseus-style score.
+     * The keys of this object are the values of the array returned
+     * from `getWidgetIds`.
+     */
+    scoreWidgets: () => {
+        [widgetId: string]: PerseusScore;
+    };
+    /**
+     * Grades the content.
+     */
+    score: () => PerseusScore;
+    guessAndScore: () => [any, PerseusScore];
+    examples: () => ReadonlyArray<string> | null | undefined;
+    handletranslationLintErrors: (lintErrors: ReadonlyArray<string>) => void;
+    render(): React.ReactNode;
+}
+export default Renderer;

package/dist/renderer.js.flow

@@ -0,0 +1,327 @@
+/**
+ * Flowtype definitions for data
+ * Generated by Flowgen from a Typescript Definition
+ * Flowgen v1.21.0
+ * @flow
+ */
+import * as React from "react";
+import InteractionTracker from "./interaction-tracker";
+import TranslationLinter from "./translation-linter";
+import type { PerseusRenderer, PerseusWidgetOptions } from "./perseus-types";
+import type {
+  APIOptions,
+  APIOptionsWithDefaults,
+  FilterCriterion,
+  FocusPath,
+  LinterContextProps,
+  PerseusDependencies,
+  PerseusScore,
+  WidgetInfo,
+  WidgetProps,
+} from "./types";
+import "./styles/perseus-renderer.less";
+declare type WidgetState = {|
+  isMobile?: boolean,
+  inTable?: boolean,
+  key?: number,
+  paragraphIndex?: number,
+  foundFullWidth?: boolean,
+  baseElements?: any,
+|};
+declare type SetWidgetPropsFn = (
+  id: string,
+  newProps: any,
+  cb: () => boolean,
+  silent?: boolean
+) => void;
+declare type WidgetUserInput = any;
+declare type SerializedState = {
+  [id: string]: any,
+};
+export type Widget = {|
+  focus: () =>
+    | {|
+        id: string,
+        path: FocusPath,
+      |}
+    | boolean,
+  getDOMNodeForPath: (path: FocusPath) => Element | Text | null,
+  deselectIncorrectSelectedChoices?: () => void,
+  restoreSerializedState: (props: any, callback: () => void) => any,
+  getSerializedState?: () => SerializedState,
+  getGrammarTypeForPath: (path: FocusPath) => string,
+  blurInputPath?: (path: FocusPath) => null,
+  focusInputPath?: (path: FocusPath) => null,
+  getInputPaths?: () => $ReadOnlyArray<FocusPath>,
+  setInputValue?: (
+    path: FocusPath,
+    newValue: string,
+    focus: () => mixed
+  ) => void,
+  getUserInput?: () => WidgetUserInput | null | void,
+  simpleValidate?: (
+    options?: any,
+    onOutputError?: (
+      widgetId: any,
+      value: string,
+      message?: string | null | void
+    ) => mixed | null | void
+  ) => PerseusScore,
+  showRationalesForCurrentlySelectedChoices?: (options?: any) => void,
+  examples?: () => $ReadOnlyArray<string>,
+|};
+declare type Props = {|
+  apiOptions?: APIOptions,
+  alwaysUpdate?: boolean,
+  findExternalWidgets: any,
+  highlightedWidgets?: $ReadOnlyArray<any>,
+  images: $PropertyType<PerseusRenderer, "images">,
+  keypadElement?: any,
+  onInteractWithWidget: (id: string) => void,
+  onRender: (node?: any) => void,
+  problemNum?: number,
+  questionCompleted?: boolean,
+  reviewMode?: boolean | null | void,
+  content: $PropertyType<PerseusRenderer, "content">,
+  serializedState?: any,
+  onSerializedStateUpdated: (serializedState: {
+    [key: string]: any,
+  }) => mixed,
+  linterContext: LinterContextProps,
+  legacyPerseusLint?: $ReadOnlyArray<string>,
+  widgets: $PropertyType<PerseusRenderer, "widgets">,
+|};
+declare type State = {|
+  translationLintErrors: $ReadOnlyArray<string>,
+  widgetInfo: $ReadOnly<{
+    [id: string]: WidgetInfo | null | void,
+  }>,
+  widgetProps: $ReadOnly<{
+    [id: string]: any | null | void,
+  }>,
+  jiptContent: any,
+  lastUsedWidgetId: string | null | void,
+|};
+declare type Context = {|
+  ...LinterContextProps,
+  ...{|
+    content: string,
+    widgets: {
+      [id: string]: any,
+    },
+  |},
+|};
+declare type DefaultProps = {|
+  alwaysUpdate: $PropertyType<Props, "alwaysUpdate">,
+  content: $PropertyType<Props, "content">,
+  findExternalWidgets: $PropertyType<Props, "findExternalWidgets">,
+  highlightedWidgets: $PropertyType<Props, "highlightedWidgets">,
+  images: $PropertyType<Props, "images">,
+  linterContext: $PropertyType<Props, "linterContext">,
+  onInteractWithWidget: $PropertyType<Props, "onInteractWithWidget">,
+  onRender: $PropertyType<Props, "onRender">,
+  onSerializedStateUpdated: $PropertyType<Props, "onSerializedStateUpdated">,
+  questionCompleted: $PropertyType<Props, "questionCompleted">,
+  reviewMode: $PropertyType<Props, "reviewMode">,
+  serializedState: $PropertyType<Props, "serializedState">,
+  widgets: $PropertyType<Props, "widgets">,
+|};
+declare class Renderer extends React.Component<Props, State> {
+  _currentFocus: FocusPath | null | void;
+  _foundTextNodes: boolean;
+  _interactionTrackers: {
+    [id: string]: InteractionTracker,
+  };
+  _isMounted: boolean;
+  _isTwoColumn: boolean;
+  _translationLinter: TranslationLinter;
+  lastRenderedMarkdown: React.Element<$PropertyType<PerseusDependencies, "KatexProvider">
+  >;
+  reuseMarkdown: boolean;
+  translationIndex: number;
+  widgetIds: Array<string>;
+  static defaultProps: DefaultProps;
+  constructor(props: Props, context: Context): this;
+  componentDidMount(): void;
+  UNSAFE_componentWillReceiveProps(nextProps: Props): void;
+  shouldComponentUpdate(nextProps: Props, nextState: State): any | boolean;
+  UNSAFE_componentWillUpdate(nextProps: Props, nextState: State): void;
+  componentDidUpdate(prevProps: Props, prevState: State): void;
+  componentWillUnmount(): void;
+  getApiOptions: () => APIOptionsWithDefaults;
+  _getInitialWidgetState: (props: Props) => {|
+    widgetInfo: $PropertyType<State, "widgetInfo">,
+    widgetProps: $PropertyType<State, "widgetProps">,
+  |};
+  _getAllWidgetsInfo: (props: Props) => {
+    [key: string]: WidgetInfo,
+  };
+  _getAllWidgetsStartProps: (
+    allWidgetInfo: {
+      [key: string]: WidgetInfo,
+    },
+    props: Props
+  ) => any;
+  _getDefaultWidgetInfo: (widgetId: string) => any;
+  _getWidgetInfo: (widgetId: string) => WidgetInfo;
+  renderWidget: (
+    impliedType: string,
+    id: string,
+    state: WidgetState
+  ) => null | React.Node;
+  getWidgetProps: (id: string) => WidgetProps<any, PerseusWidgetOptions>;
+
+  /**
+   * Serializes the questions state so it can be recovered.
+   *
+   * The return value of this function can be sent to the
+   * `restoreSerializedState` method to restore this state.
+   *
+   * If an instance of widgetProps is passed in, it generates the serialized
+   * state from that instead of the current widget props.
+   */
+  getSerializedState: (widgetProps?: any) => {
+    [id: string]: any,
+  };
+  restoreSerializedState: (
+    serializedState: SerializedState,
+    callback?: () => void
+  ) => void;
+
+  /**
+   * Tell each of the radio widgets to show rationales for each of the
+   * currently selected choices inside of them. If the widget is correct, it
+   * shows rationales for all of the choices. This also disables interaction
+   * with the choices that we show rationales for.
+   */
+  showRationalesForCurrentlySelectedChoices: () => void;
+
+  /**
+   * Tells each of the radio widgets to deselect any of the incorrect choices
+   * that are currently selected (leaving correct choices still selected).
+   */
+  deselectIncorrectSelectedChoices: () => void;
+
+  /**
+   * Allows inter-widget communication.
+   *
+   * This function yields this Renderer's own internal widgets, and it's used
+   * in two places.
+   *
+   * First, we expose our own internal widgets to each other by giving them
+   * a `findWidgets` function that, in turn, calls this function.
+   *
+   * Second, we expose our own internal widgets to this Renderer's parent,
+   * by allowing it to call this function directly. That way, it can hook us
+   * up to other Renderers on the page, by writing a `findExternalWidgets`
+   * prop that calls each other Renderer's `findInternalWidgets` function.
+   *
+   * Takes a `filterCriterion` on which widgets to return.
+   * `filterCriterion` can be one of:
+   *  * A string widget id
+   *  * A string widget type
+   *  * a function from (id, widgetInfo, widgetComponent) to true or false
+   *
+   * Returns an array of the matching widget components.
+   *
+   * If you need to do logic with more than the components, it is possible
+   * to do such logic inside the filter, rather than on the result array.
+   *
+   * See the passage-ref widget for an example.
+   *
+   * "Remember: abilities are not inherently good or evil, it's how you use
+   * them." ~ Kyle Katarn
+   * Please use this one with caution.
+   */
+  findInternalWidgets: (
+    filterCriterion: FilterCriterion
+  ) => $ReadOnlyArray<Widget | null | void>;
+
+  /**
+   * Allows inter-widget communication.
+   *
+   * Includes both widgets internal to this Renderer, and external widgets
+   * exposed by the `findExternalWidgets` prop.
+   *
+   * See `findInteralWidgets` for more information.
+   */
+  findWidgets: (filterCriterion: FilterCriterion) => any;
+  getWidgetInstance: (id: string) => Widget | null | void;
+  _onWidgetFocus: (id: string, focusPath?: $ReadOnlyArray<string>) => void;
+  _onWidgetBlur: (id: string, blurPath: FocusPath) => void;
+  getContent: (props: Props, state: State) => any;
+  shouldRenderJiptPlaceholder: (props: Props, state: State) => boolean;
+  replaceJiptContent: (content: string, paragraphIndex: number) => void;
+  outputMarkdown: (ast: any, state: WidgetState) => React.Element<any>;
+  outputNested: (ast: any, state: WidgetState) => React.Element<any>;
+  outputNode: (
+    node: any,
+    nestedOutput: any,
+    state: WidgetState
+  ) =>
+    | any
+    | null
+    | React.Element<"div">
+    | React.Element<"span">
+    | React.Node;
+  handleRender: (prevProps: Props) => void;
+  _setCurrentFocus: (path: FocusPath) => void;
+  focus: () => boolean | null | void;
+  getDOMNodeForPath: (path: FocusPath) => Element | Text | null | void;
+  getGrammarTypeForPath: (path: FocusPath) => string | null | void;
+  getInputPaths: () => $ReadOnlyArray<FocusPath>;
+  focusPath: (path: FocusPath) => void;
+  blurPath: (path: FocusPath) => void;
+  blur: () => void;
+  serialize: () => { [key: any]: any };
+  emptyWidgets: () => any;
+  _setWidgetProps: SetWidgetPropsFn;
+  setInputValue: (
+    path: FocusPath,
+    newValue: string,
+    focus: () => mixed
+  ) => void;
+
+  /**
+   * Returns an array of the widget `.getUserInput()` results
+   */
+  getUserInput: () => $ReadOnlyArray<WidgetUserInput | null | void>;
+
+  /**
+   * Returns an array of all widget IDs in the order they occur in
+   * the content.
+   */
+  getWidgetIds: () => $ReadOnlyArray<string>;
+
+  /**
+   * Returns the result of `.getUserInput()` for each widget, in
+   * a map from widgetId to userInput.
+   * NOTE(jeremy): This function is hauntingly similar to `getUserInput` with
+   * the major difference being that this function returns a map of
+   * `widgetID` => UserInput and `getUserInput` simply returns an array. It
+   * would be trivial to map between the results of each of these functions,
+   * so we should aim to remove one of these functions.
+   */
+  getUserInputForWidgets: () => {
+    [widgetId: string]: WidgetUserInput | null | void,
+  };
+
+  /**
+   * Returns an object mapping from widget ID to perseus-style score.
+   * The keys of this object are the values of the array returned
+   * from `getWidgetIds`.
+   */
+  scoreWidgets: () => {
+    [widgetId: string]: PerseusScore,
+  };
+
+  /**
+   * Grades the content.
+   */
+  score: () => PerseusScore;
+  guessAndScore: () => [any, PerseusScore];
+  examples: () => $ReadOnlyArray<string> | null | void;
+  handletranslationLintErrors: (lintErrors: $ReadOnlyArray<string>) => void;
+  render(): React.Node;
+}
+declare export default typeof Renderer;