@khanacademy/perseus 3.0.0 → 4.0.0

package/dist/util.d.ts

@@ -0,0 +1,247 @@
+import type { Widget, PerseusScore, KEScore } from "./types";
+type WordPosition = {
+    start: number;
+    end: number;
+};
+type WordAndPosition = {
+    string: string;
+    pos: WordPosition;
+};
+type RNG = () => number;
+export type ParsedValue = {
+    value: number;
+    exact: boolean;
+};
+type Coordinates = [number, number];
+export type GridDimensions = {
+    scale: number;
+    tickStep: number;
+    unityLabel: boolean;
+};
+type QueryParams = {
+    [param: string]: string;
+};
+type Position = {
+    top: number;
+    left: number;
+};
+type TouchHandlers = {
+    pointerDown: boolean;
+    currentTouchIdentifier: string | null | undefined;
+};
+/**
+ * Used to compare equality of two input paths, which are represented as
+ * arrays of strings.
+ */
+declare function inputPathsEqual(a?: ReadonlyArray<string> | null, b?: ReadonlyArray<string> | null): boolean;
+declare function shuffle<T>(array: ReadonlyArray<T>, randomSeed: number | RNG, ensurePermuted?: boolean): ReadonlyArray<T>;
+/**
+ * Combine two score objects.
+ *
+ * Given two score objects for two different widgets, combine them so that
+ * if one is wrong, the total score is wrong, etc.
+ */
+declare function combineScores(scoreA: PerseusScore, scoreB: PerseusScore): PerseusScore;
+declare function keScoreFromPerseusScore(score: PerseusScore, guess: any, state: any): KEScore;
+/**
+ * Return the first valid interpretation of 'text' as a number, in the form
+ * {value: 2.3, exact: true}.
+ */
+declare function firstNumericalParse(text: string): ParsedValue | null | undefined;
+declare function stringArrayOfSize(size: number): ReadonlyArray<string>;
+/**
+ * For a graph's x or y dimension, given the tick step,
+ * the ranges extent (e.g. [-10, 10]), the pixel dimension constraint,
+ * and the grid step, return a bunch of configurations for that dimension.
+ *
+ * Example:
+ *      gridDimensionConfig(10, [-50, 50], 400, 5)
+ *
+ * Returns: {
+ *      scale: 4,
+ *      snap: 2.5,
+ *      tickStep: 2,
+ *      unityLabel: true
+ * };
+ */
+declare function gridDimensionConfig(absTickStep: number, extent: Coordinates, dimensionConstraint: number, gridStep: number): GridDimensions;
+/**
+ * Given the range, step, and boxSize, calculate the reasonable gridStep.
+ * Used for when one was not given explicitly.
+ *
+ * Example:
+ *      getGridStep([[-10, 10], [-10, 10]], [1, 1], 340)
+ *
+ * Returns: [1, 1]
+ *
+ * TODO(somewhatabstract, FEI-3464): Consolidate query string parsing functions.
+ */
+declare function getGridStep(range: [Coordinates, Coordinates], step: Coordinates, boxSize: number): Coordinates;
+declare function snapStepFromGridStep(gridStep: [number, number]): [number, number];
+/**
+ * Given the tickStep and the graph's scale, find a
+ * grid step.
+ * Example:
+ *      gridStepFromTickStep(200, 0.2) // returns 100
+ */
+declare function gridStepFromTickStep(tickStep: number, scale: number): number | null | undefined;
+/**
+ * Given the range and a dimension, come up with the appropriate
+ * scale.
+ * Example:
+ *      scaleFromExtent([-25, 25], 500) // returns 10
+ */
+declare function scaleFromExtent(extent: Coordinates, dimensionConstraint: number): number;
+/**
+ * Return a reasonable tick step given extent and dimension.
+ * (extent is [begin, end] of the domain.)
+ * Example:
+ *      tickStepFromExtent([-10, 10], 300) // returns 2
+ */
+declare function tickStepFromExtent(extent: Coordinates, dimensionConstraint: number): number;
+/**
+ * Find a good tick step for the desired number of ticks in the range
+ * Modified from d3.scale.linear: d3_scale_linearTickRange.
+ * Thanks, mbostock!
+ * Example:
+ *      tickStepFromNumTicks(50, 6) // returns 10
+ */
+declare function tickStepFromNumTicks(span: number, numTicks: number): number;
+type Range = [number, number];
+/**
+ * Constrain tick steps intended for desktop size graphs
+ * to something more suitable for mobile size graphs.
+ * Specifically, we aim for 10 or fewer ticks per graph axis.
+ */
+declare function constrainedTickStepsFromTickSteps(tickSteps: Coordinates, ranges: [Range, Range]): Coordinates;
+/**
+ * Approximate equality on numbers and primitives.
+ */
+declare function eq<T>(x: T, y: T): boolean;
+/**
+ * Deep approximate equality on primitives, numbers, arrays, and objects.
+ * Recursive.
+ */
+declare function deepEq<T>(x: T, y: T): boolean;
+/**
+ * Query String Parser
+ *
+ * Original from:
+ * http://stackoverflow.com/questions/901115/get-querystring-values-in-javascript/2880929#2880929
+ */
+declare function parseQueryString(query: string): QueryParams;
+/**
+ * Query string adder
+ * Works for URLs without #.
+ * Original from:
+ * http://stackoverflow.com/questions/5999118/add-or-update-query-string-parameter
+ */
+declare function updateQueryString(uri: string, key: string, value: string): string;
+/**
+ * A more strict encodeURIComponent that escapes `()'!`s
+ * Especially useful for creating URLs that are embeddable in markdown
+ *
+ * Adapted from
+ * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent
+ * This function and the above original available under the
+ * CC-BY-SA 2.5 license.
+ */
+declare function strongEncodeURIComponent(str: string): string;
+/**
+ * TODO(somewhatabstract, JIRA-XXXX):
+ * This does not appear to be used within webapp. Could be dead code.
+ * Need to check with mobile.
+ */
+declare function widgetShouldHighlight(widget: Widget): boolean;
+/**
+ * If a widget says that it is empty once it is graded.
+ * Trying to encapsulate references to the score format.
+ */
+declare function scoreIsEmpty(score: PerseusScore): boolean;
+declare function resetTouchHandlers(): void;
+/**
+ * Extracts the location of a touch or mouse event, allowing you to pass
+ * in a "mouseup", "mousedown", or "mousemove" event and receive the
+ * correct coordinates. Shouldn't be used with "vmouse" events.
+ */
+declare function extractPointerLocation(event: any): Position | null | undefined;
+/**
+ * Pass this function as the touchstart for an element to
+ * avoid sending the touch to the mobile scratchpad
+ */
+declare function captureScratchpadTouchStart(e: TouchEvent): void;
+declare function getImageSize(url: string, callback: (arg1: number, arg2: number) => void): void;
+declare function getRealImageUrl(url: string): string;
+declare function isLabeledSVG(url: string): boolean;
+declare function getBaseUrl(url: string): string;
+declare function getSvgUrl(url: string): string;
+declare function getDataUrl(url: string): string;
+/**
+ * Gets the word right before where the textarea cursor is
+ *
+ * @param {Element} textarea - The textarea DOM element
+ * @return {JSON} - An object with the word and its starting and ending positions in the textarea
+ */
+declare function getWordBeforeCursor(textarea: HTMLTextAreaElement): WordAndPosition;
+/**
+ * Moves the textarea cursor at the specified position
+ *
+ * @param {Element} textarea - The textarea DOM element
+ * @param {int} pos - The position where the cursor will be moved
+ */
+declare function moveCursor(textarea: HTMLTextAreaElement, pos: number): void;
+declare const Util: {
+    readonly inputPathsEqual: typeof inputPathsEqual;
+    readonly nestedMap: <T, M>(children: T | readonly T[], func: (arg1: T) => M, context: unknown) => M | readonly M[];
+    readonly rWidgetRule: RegExp;
+    readonly rTypeFromWidgetId: RegExp;
+    readonly rWidgetParts: RegExp;
+    readonly snowman: "☃";
+    readonly noScore: {
+        type: "points";
+        earned: number;
+        total: number;
+        message?: string | null | undefined;
+    };
+    readonly seededRNG: (seed: number) => RNG;
+    readonly shuffle: typeof shuffle;
+    readonly split: (str: string, r: RegExp) => ReadonlyArray<string>;
+    readonly combineScores: typeof combineScores;
+    readonly keScoreFromPerseusScore: typeof keScoreFromPerseusScore;
+    readonly firstNumericalParse: typeof firstNumericalParse;
+    readonly stringArrayOfSize: typeof stringArrayOfSize;
+    readonly gridDimensionConfig: typeof gridDimensionConfig;
+    readonly getGridStep: typeof getGridStep;
+    readonly snapStepFromGridStep: typeof snapStepFromGridStep;
+    readonly scaleFromExtent: typeof scaleFromExtent;
+    readonly tickStepFromExtent: typeof tickStepFromExtent;
+    readonly gridStepFromTickStep: typeof gridStepFromTickStep;
+    readonly tickStepFromNumTicks: typeof tickStepFromNumTicks;
+    readonly constrainedTickStepsFromTickSteps: typeof constrainedTickStepsFromTickSteps;
+    readonly DeprecationMixin: any;
+    readonly eq: typeof eq;
+    readonly deepEq: typeof deepEq;
+    readonly parseQueryString: typeof parseQueryString;
+    readonly updateQueryString: typeof updateQueryString;
+    readonly strongEncodeURIComponent: typeof strongEncodeURIComponent;
+    readonly widgetShouldHighlight: typeof widgetShouldHighlight;
+    readonly scoreIsEmpty: typeof scoreIsEmpty;
+    readonly touchHandlers: TouchHandlers;
+    readonly resetTouchHandlers: typeof resetTouchHandlers;
+    readonly extractPointerLocation: typeof extractPointerLocation;
+    readonly supportsPassiveEvents: () => boolean;
+    readonly captureScratchpadTouchStart: typeof captureScratchpadTouchStart;
+    readonly getImageSize: typeof getImageSize;
+    readonly getRealImageUrl: typeof getRealImageUrl;
+    readonly isLabeledSVG: typeof isLabeledSVG;
+    readonly getBaseUrl: typeof getBaseUrl;
+    readonly getSvgUrl: typeof getSvgUrl;
+    readonly getDataUrl: typeof getDataUrl;
+    readonly textarea: {
+        readonly getWordBeforeCursor: typeof getWordBeforeCursor;
+        readonly moveCursor: typeof moveCursor;
+    };
+    readonly unescapeMathMode: (label: string) => string;
+    readonly random: RNG;
+};
+export default Util;

package/dist/util.js.flow

@@ -0,0 +1,320 @@
+/**
+ * Flowtype definitions for data
+ * Generated by Flowgen from a Typescript Definition
+ * Flowgen v1.21.0
+ * @flow
+ */
+import type { Widget, PerseusScore, KEScore } from "./types";
+declare type WordPosition = {|
+  start: number,
+  end: number,
+|};
+declare type WordAndPosition = {|
+  string: string,
+  pos: WordPosition,
+|};
+declare type RNG = () => number;
+export type ParsedValue = {|
+  value: number,
+  exact: boolean,
+|};
+declare type Coordinates = [number, number];
+export type GridDimensions = {|
+  scale: number,
+  tickStep: number,
+  unityLabel: boolean,
+|};
+declare type QueryParams = {
+  [param: string]: string,
+};
+declare type Position = {|
+  top: number,
+  left: number,
+|};
+declare type TouchHandlers = {|
+  pointerDown: boolean,
+  currentTouchIdentifier: string | null | void,
+|};
+/**
+ * Used to compare equality of two input paths, which are represented as
+ * arrays of strings.
+ */
+declare function inputPathsEqual(
+  a?: $ReadOnlyArray<string> | null,
+  b?: $ReadOnlyArray<string> | null
+): boolean;
+declare function shuffle<T>(
+  array: $ReadOnlyArray<T>,
+  randomSeed: number | RNG,
+  ensurePermuted?: boolean
+): $ReadOnlyArray<T>;
+
+/**
+ * Combine two score objects.
+ *
+ * Given two score objects for two different widgets, combine them so that
+ * if one is wrong, the total score is wrong, etc.
+ */
+declare function combineScores(
+  scoreA: PerseusScore,
+  scoreB: PerseusScore
+): PerseusScore;
+declare function keScoreFromPerseusScore(
+  score: PerseusScore,
+  guess: any,
+  state: any
+): KEScore;
+
+/**
+ * Return the first valid interpretation of 'text' as a number, in the form
+ * {value: 2.3, exact: true}.
+ */
+declare function firstNumericalParse(text: string): ParsedValue | null | void;
+declare function stringArrayOfSize(size: number): $ReadOnlyArray<string>;
+
+/**
+ * For a graph's x or y dimension, given the tick step,
+ * the ranges extent (e.g. [-10, 10]), the pixel dimension constraint,
+ * and the grid step, return a bunch of configurations for that dimension.
+ *
+ * Example:
+ *      gridDimensionConfig(10, [-50, 50], 400, 5)
+ *
+ * Returns: {
+ *      scale: 4,
+ *      snap: 2.5,
+ *      tickStep: 2,
+ *      unityLabel: true
+ * };
+ */
+declare function gridDimensionConfig(
+  absTickStep: number,
+  extent: Coordinates,
+  dimensionConstraint: number,
+  gridStep: number
+): GridDimensions;
+
+/**
+ * Given the range, step, and boxSize, calculate the reasonable gridStep.
+ * Used for when one was not given explicitly.
+ *
+ * Example:
+ *      getGridStep([[-10, 10], [-10, 10]], [1, 1], 340)
+ *
+ * Returns: [1, 1]
+ *
+ * TODO(somewhatabstract, FEI-3464): Consolidate query string parsing functions.
+ */
+declare function getGridStep(
+  range: [Coordinates, Coordinates],
+  step: Coordinates,
+  boxSize: number
+): Coordinates;
+declare function snapStepFromGridStep(
+  gridStep: [number, number]
+): [number, number];
+
+/**
+ * Given the tickStep and the graph's scale, find a
+ * grid step.
+ * Example:
+ *      gridStepFromTickStep(200, 0.2) // returns 100
+ */
+declare function gridStepFromTickStep(
+  tickStep: number,
+  scale: number
+): number | null | void;
+
+/**
+ * Given the range and a dimension, come up with the appropriate
+ * scale.
+ * Example:
+ *      scaleFromExtent([-25, 25], 500) // returns 10
+ */
+declare function scaleFromExtent(
+  extent: Coordinates,
+  dimensionConstraint: number
+): number;
+
+/**
+ * Return a reasonable tick step given extent and dimension.
+ * (extent is [begin, end] of the domain.)
+ * Example:
+ *      tickStepFromExtent([-10, 10], 300) // returns 2
+ */
+declare function tickStepFromExtent(
+  extent: Coordinates,
+  dimensionConstraint: number
+): number;
+
+/**
+ * Find a good tick step for the desired number of ticks in the range
+ * Modified from d3.scale.linear: d3_scale_linearTickRange.
+ * Thanks, mbostock!
+ * Example:
+ *      tickStepFromNumTicks(50, 6) // returns 10
+ */
+declare function tickStepFromNumTicks(span: number, numTicks: number): number;
+declare type Range = [number, number];
+/**
+ * Constrain tick steps intended for desktop size graphs
+ * to something more suitable for mobile size graphs.
+ * Specifically, we aim for 10 or fewer ticks per graph axis.
+ */
+declare function constrainedTickStepsFromTickSteps(
+  tickSteps: Coordinates,
+  ranges: [Range, Range]
+): Coordinates;
+
+/**
+ * Approximate equality on numbers and primitives.
+ */
+declare function eq<T>(x: T, y: T): boolean;
+
+/**
+ * Deep approximate equality on primitives, numbers, arrays, and objects.
+ * Recursive.
+ */
+declare function deepEq<T>(x: T, y: T): boolean;
+
+/**
+ * Query String Parser
+ *
+ * Original from:
+ * http://stackoverflow.com/questions/901115/get-querystring-values-in-javascript/2880929#2880929
+ */
+declare function parseQueryString(query: string): QueryParams;
+
+/**
+ * Query string adder
+ * Works for URLs without #.
+ * Original from:
+ * http://stackoverflow.com/questions/5999118/add-or-update-query-string-parameter
+ */
+declare function updateQueryString(
+  uri: string,
+  key: string,
+  value: string
+): string;
+
+/**
+ * A more strict encodeURIComponent that escapes `()'!`s
+ * Especially useful for creating URLs that are embeddable in markdown
+ *
+ * Adapted from
+ * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent
+ * This function and the above original available under the
+ * CC-BY-SA 2.5 license.
+ */
+declare function strongEncodeURIComponent(str: string): string;
+
+/**
+ * TODO(somewhatabstract, JIRA-XXXX):
+ * This does not appear to be used within webapp. Could be dead code.
+ * Need to check with mobile.
+ */
+declare function widgetShouldHighlight(widget: Widget): boolean;
+
+/**
+ * If a widget says that it is empty once it is graded.
+ * Trying to encapsulate references to the score format.
+ */
+declare function scoreIsEmpty(score: PerseusScore): boolean;
+declare function resetTouchHandlers(): void;
+
+/**
+ * Extracts the location of a touch or mouse event, allowing you to pass
+ * in a "mouseup", "mousedown", or "mousemove" event and receive the
+ * correct coordinates. Shouldn't be used with "vmouse" events.
+ */
+declare function extractPointerLocation(event: any): Position | null | void;
+
+/**
+ * Pass this function as the touchstart for an element to
+ * avoid sending the touch to the mobile scratchpad
+ */
+declare function captureScratchpadTouchStart(e: TouchEvent): void;
+declare function getImageSize(
+  url: string,
+  callback: (arg1: number, arg2: number) => void
+): void;
+declare function getRealImageUrl(url: string): string;
+declare function isLabeledSVG(url: string): boolean;
+declare function getBaseUrl(url: string): string;
+declare function getSvgUrl(url: string): string;
+declare function getDataUrl(url: string): string;
+
+/**
+ * Gets the word right before where the textarea cursor is
+ * @param {Element} textarea - The textarea DOM element
+ * @return {JSON} - An object with the word and its starting and ending positions in the textarea
+ */
+declare function getWordBeforeCursor(
+  textarea: HTMLTextAreaElement
+): WordAndPosition;
+
+/**
+ * Moves the textarea cursor at the specified position
+ * @param {Element} textarea - The textarea DOM element
+ * @param {int} pos - The position where the cursor will be moved
+ */
+declare function moveCursor(textarea: HTMLTextAreaElement, pos: number): void;
+declare var Util: {|
+  +inputPathsEqual: typeof inputPathsEqual,
+  +nestedMap: <T, M>(
+    children: T | $ReadOnlyArray<T>,
+    func: (arg1: T) => M,
+    context: mixed
+  ) => M | $ReadOnlyArray<M>,
+  +rWidgetRule: RegExp,
+  +rTypeFromWidgetId: RegExp,
+  +rWidgetParts: RegExp,
+  +snowman: "☃",
+  +noScore: {|
+    type: "points",
+    earned: number,
+    total: number,
+    message?: string | null | void,
+  |},
+  +seededRNG: (seed: number) => RNG,
+  +shuffle: typeof shuffle,
+  +split: (str: string, r: RegExp) => $ReadOnlyArray<string>,
+  +combineScores: typeof combineScores,
+  +keScoreFromPerseusScore: typeof keScoreFromPerseusScore,
+  +firstNumericalParse: typeof firstNumericalParse,
+  +stringArrayOfSize: typeof stringArrayOfSize,
+  +gridDimensionConfig: typeof gridDimensionConfig,
+  +getGridStep: typeof getGridStep,
+  +snapStepFromGridStep: typeof snapStepFromGridStep,
+  +scaleFromExtent: typeof scaleFromExtent,
+  +tickStepFromExtent: typeof tickStepFromExtent,
+  +gridStepFromTickStep: typeof gridStepFromTickStep,
+  +tickStepFromNumTicks: typeof tickStepFromNumTicks,
+  +constrainedTickStepsFromTickSteps: typeof constrainedTickStepsFromTickSteps,
+  +DeprecationMixin: any,
+  +eq: typeof eq,
+  +deepEq: typeof deepEq,
+  +parseQueryString: typeof parseQueryString,
+  +updateQueryString: typeof updateQueryString,
+  +strongEncodeURIComponent: typeof strongEncodeURIComponent,
+  +widgetShouldHighlight: typeof widgetShouldHighlight,
+  +scoreIsEmpty: typeof scoreIsEmpty,
+  +touchHandlers: TouchHandlers,
+  +resetTouchHandlers: typeof resetTouchHandlers,
+  +extractPointerLocation: typeof extractPointerLocation,
+  +supportsPassiveEvents: () => boolean,
+  +captureScratchpadTouchStart: typeof captureScratchpadTouchStart,
+  +getImageSize: typeof getImageSize,
+  +getRealImageUrl: typeof getRealImageUrl,
+  +isLabeledSVG: typeof isLabeledSVG,
+  +getBaseUrl: typeof getBaseUrl,
+  +getSvgUrl: typeof getSvgUrl,
+  +getDataUrl: typeof getDataUrl,
+  +textarea: {|
+    +getWordBeforeCursor: typeof getWordBeforeCursor,
+    +moveCursor: typeof moveCursor,
+  |},
+  +unescapeMathMode: (label: string) => string,
+  +random: RNG,
+|};
+declare export default typeof Util;

package/dist/version.d.ts

@@ -0,0 +1,11 @@
+declare const _default: {
+    apiVersion: {
+        major: number;
+        minor: number;
+    };
+    itemDataVersion: {
+        major: number;
+        minor: number;
+    };
+};
+export default _default;

package/dist/version.js.flow

@@ -0,0 +1,17 @@
+/**
+ * Flowtype definitions for data
+ * Generated by Flowgen from a Typescript Definition
+ * Flowgen v1.21.0
+ * @flow
+ */
+declare var _default: {|
+  apiVersion: {|
+    major: number,
+    minor: number,
+  |},
+  itemDataVersion: {|
+    major: number,
+    minor: number,
+  |},
+|};
+declare export default typeof _default;

package/dist/widget-container.d.ts

@@ -0,0 +1,27 @@
+import * as React from "react";
+import type { PerseusWidgetOptions } from "./perseus-types";
+import type { LinterContextProps, WidgetProps } from "./types";
+type Props = {
+    shouldHighlight: boolean;
+    type: string;
+    initialProps: WidgetProps<any, PerseusWidgetOptions>;
+    linterContext: LinterContextProps;
+};
+type DefaultProps = {
+    linterContext: LinterContextProps;
+};
+type State = {
+    sizeClass: "small" | "medium" | "large" | "xlarge";
+    widgetProps: WidgetProps<any, PerseusWidgetOptions>;
+};
+declare class WidgetContainer extends React.Component<Props, State> {
+    static defaultProps: DefaultProps;
+    state: any;
+    componentDidMount(): void;
+    render(): React.ReactNode;
+    UNSAFE_componentWillReceiveProps(nextProps: Props): void;
+    shouldComponentUpdate(nextProps: Props, nextState: State): boolean;
+    getWidget: () => any;
+    replaceWidgetProps: (arg1: WidgetProps<any, PerseusWidgetOptions>) => void;
+}
+export default WidgetContainer;

package/dist/widget-container.js.flow

@@ -0,0 +1,33 @@
+/**
+ * Flowtype definitions for data
+ * Generated by Flowgen from a Typescript Definition
+ * Flowgen v1.21.0
+ * @flow
+ */
+import * as React from "react";
+import type { PerseusWidgetOptions } from "./perseus-types";
+import type { LinterContextProps, WidgetProps } from "./types";
+declare type Props = {|
+  shouldHighlight: boolean,
+  type: string,
+  initialProps: WidgetProps<any, PerseusWidgetOptions>,
+  linterContext: LinterContextProps,
+|};
+declare type DefaultProps = {|
+  linterContext: LinterContextProps,
+|};
+declare type State = {|
+  sizeClass: "small" | "medium" | "large" | "xlarge",
+  widgetProps: WidgetProps<any, PerseusWidgetOptions>,
+|};
+declare class WidgetContainer extends React.Component<Props, State> {
+  static defaultProps: DefaultProps;
+  state: any;
+  componentDidMount(): void;
+  render(): React.Node;
+  UNSAFE_componentWillReceiveProps(nextProps: Props): void;
+  shouldComponentUpdate(nextProps: Props, nextState: State): boolean;
+  getWidget: () => any;
+  replaceWidgetProps: (arg1: WidgetProps<any, PerseusWidgetOptions>) => void;
+}
+declare export default typeof WidgetContainer;

package/dist/widgets/__tests__/renderQuestion.d.ts

@@ -0,0 +1,13 @@
+import { render } from "@testing-library/react";
+import * as React from "react";
+import * as Perseus from "../../index";
+import type { PerseusRenderer } from "../../perseus-types";
+import type { APIOptions } from "../../types";
+type RenderResult = ReturnType<typeof render>;
+export declare const renderQuestion: (question: PerseusRenderer, apiOptions?: APIOptions, extraProps?: JSX.LibraryManagedAttributes<typeof Perseus.Renderer, React.ComponentProps<typeof Perseus.Renderer>>) => {
+    container: HTMLElement;
+    renderer: Perseus.Renderer;
+    rerender: (question: PerseusRenderer, extraProps?: JSX.LibraryManagedAttributes<typeof Perseus.Renderer, React.ComponentProps<typeof Perseus.Renderer>>) => void;
+    unmount: RenderResult["unmount"];
+};
+export {};

package/dist/widgets/__tests__/renderQuestion.js.flow

@@ -0,0 +1,28 @@
+/**
+ * Flowtype definitions for data
+ * Generated by Flowgen from a Typescript Definition
+ * Flowgen v1.21.0
+ * @flow
+ */
+import { render } from "@testing-library/react";
+import * as React from "react";
+import * as Perseus from "../../index";
+import type { PerseusRenderer } from "../../perseus-types";
+import type { APIOptions } from "../../types";
+declare type RenderResult = $Call<
+  <R>((...args: any[]) => R) => R,
+  typeof render
+>;
+declare export var renderQuestion: (
+  question: PerseusRenderer,
+  apiOptions?: APIOptions,
+  extraProps?: React.ElementConfig<typeof Perseus.Renderer>
+) => {|
+  container: HTMLElement,
+  renderer: Perseus.Renderer,
+  rerender: (
+    question: PerseusRenderer,
+    extraProps?: React.ElementConfig<typeof Perseus.Renderer>
+  ) => void,
+  unmount: $PropertyType<RenderResult, "unmount">,
+|};