@khanacademy/perseus 7.2.0 → 8.0.0

package/dist/a11y.js.flow

@@ -1,11 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * Identifies whether or not a given perseus item requires the use of a mouse
- * or screen, based on the widgets it contains.
- */
-declare export function violatingWidgets(itemData: any): any;

package/dist/all-widgets.js.flow

@@ -1,33 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as $Flowgen$Import$react from "react";
-import * as $Flowgen$Import$_2e__2f_types from "./types";
-declare var _default: $ReadOnlyArray<
-  $ReadOnly<{|
-    name: string,
-    displayName: string,
-    getWidget?: (() => $Flowgen$Import$react.ComponentType<any>) | void,
-    accessible?: boolean | ((props: any) => boolean) | void,
-    hidden?: boolean | void,
-    version?: $Flowgen$Import$_2e__2f_types.Version | void,
-    supportedAlignments?: $ReadOnlyArray<$Flowgen$Import$_2e__2f_types.Alignment> | void,
-    defaultAlignment?: $Flowgen$Import$_2e__2f_types.Alignment | void,
-    getDefaultAlignment?:
-      | (() => $Flowgen$Import$_2e__2f_types.Alignment)
-      | void,
-    isLintable?: boolean | void,
-    tracking?: $Flowgen$Import$_2e__2f_types.Tracking | void,
-    traverseChildWidgets?: any,
-    transform?: $Flowgen$Import$_2e__2f_types.WidgetTransform | void,
-    staticTransform?: $Flowgen$Import$_2e__2f_types.WidgetTransform | void,
-    propUpgrades?: {
-      [key: string]: (arg1: any) => any,
-    } | void,
-    widget: $Flowgen$Import$react.ComponentType<any>,
-  |}>
->;
-declare export default typeof _default;

package/dist/article-renderer.js.flow

@@ -1,73 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import PropTypes from "prop-types";
-import * as React from "react";
-declare class ArticleRenderer extends React.Component<any, any> {
-  _currentFocus: any;
-  static propTypes: {|
-    apiOptions: PropTypes.Requireable<
-      PropTypes.InferProps<{|
-        onFocusChange: PropTypes.Requireable<(...args: any[]) => any>,
-        isMobile: PropTypes.Requireable<boolean>,
-      |}>
-    >,
-    json: PropTypes.Validator<
-      $NonMaybeType<
-        $NonMaybeType<
-          | PropTypes.InferProps<{|
-              content: PropTypes.Requireable<string>,
-              widgets: PropTypes.Requireable<{
-                [x: string]: any,
-              }>,
-              images: PropTypes.Requireable<{
-                [x: string]: any,
-              }>,
-            |}>
-          | (PropTypes.InferProps<{|
-              content: PropTypes.Requireable<string>,
-              widgets: PropTypes.Requireable<{
-                [x: string]: any,
-              }>,
-              images: PropTypes.Requireable<{
-                [x: string]: any,
-              }>,
-            |}> | null | void)[]
-          | null
-          | void
-        >
-      >
-    >,
-
-    /**
-     * @deprecated Does nothing
-     */
-    useNewStyles: PropTypes.Requireable<boolean>,
-    linterContext: PropTypes.Requireable<
-      PropTypes.InferProps<{|
-        contentType: PropTypes.Requireable<string>,
-        highlightLint: PropTypes.Requireable<boolean>,
-        paths: PropTypes.Requireable<(string | null | void)[]>,
-        stack: PropTypes.Requireable<(string | null | void)[]>,
-      |}>
-    >,
-    legacyPerseusLint: PropTypes.Requireable<(string | null | void)[]>,
-    keypadStyle: PropTypes.Requireable<any>,
-  |};
-  static defaultProps: any;
-  constructor(props: any): this;
-  componentDidMount(): void;
-  shouldComponentUpdate(nextProps: any, nextState: any): any;
-  componentWillUnmount(): void;
-  keypadElement: () => void;
-  _handleFocusChange: (arg1: any, arg2: any) => void;
-  _setCurrentFocus: (arg1: any) => void;
-  _onRendererBlur: (arg1: any) => void;
-  blur: () => void;
-  _sections: () => any;
-  render(): React.Node;
-}
-declare export default typeof ArticleRenderer;

package/dist/asset-context.js.flow

@@ -1,15 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as React from "react";
-declare type Context = {|
-  assetStatuses: {
-    [assetKey: string]: boolean,
-  },
-  setAssetStatus: (assetKey: string, loaded: boolean) => void,
-|};
-declare var context: React.Context<Context>;
-declare export default typeof context;

package/dist/basic-widgets.js.flow

@@ -1,33 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as $Flowgen$Import$react from "react";
-import * as $Flowgen$Import$_2e__2f_types from "./types";
-declare var _default: $ReadOnlyArray<
-  $ReadOnly<{|
-    name: string,
-    displayName: string,
-    getWidget?: (() => $Flowgen$Import$react.ComponentType<any>) | void,
-    accessible?: boolean | ((props: any) => boolean) | void,
-    hidden?: boolean | void,
-    version?: $Flowgen$Import$_2e__2f_types.Version | void,
-    supportedAlignments?: $ReadOnlyArray<$Flowgen$Import$_2e__2f_types.Alignment> | void,
-    defaultAlignment?: $Flowgen$Import$_2e__2f_types.Alignment | void,
-    getDefaultAlignment?:
-      | (() => $Flowgen$Import$_2e__2f_types.Alignment)
-      | void,
-    isLintable?: boolean | void,
-    tracking?: $Flowgen$Import$_2e__2f_types.Tracking | void,
-    traverseChildWidgets?: any,
-    transform?: $Flowgen$Import$_2e__2f_types.WidgetTransform | void,
-    staticTransform?: $Flowgen$Import$_2e__2f_types.WidgetTransform | void,
-    propUpgrades?: {
-      [key: string]: (arg1: any) => any,
-    } | void,
-    widget: $Flowgen$Import$react.ComponentType<any>,
-  |}>
->;
-declare export default typeof _default;

package/dist/components/button-group.js.flow

@@ -1,33 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as React from "react";
-declare type Props = {|
-  value: any,
-  buttons: $ReadOnlyArray<{|
-    value: any,
-    content: React.Node,
-    title?: string,
-  |}>,
-  onChange: (value?: any) => mixed,
-  allowEmpty: boolean,
-|};
-declare type DefaultProps = {|
-  allowEmpty: $PropertyType<Props, "allowEmpty">,
-  value: $PropertyType<Props, "value">,
-|};
-/**
- * ButtonGroup is an aesthetically pleasing group of buttons.
- */
-declare class ButtonGroup extends React.Component<Props> {
-  container: HTMLDivElement | null | void;
-  static defaultProps: DefaultProps;
-  componentWillUnmount(): void;
-  focus(): void | boolean;
-  toggleSelect(newValue: any): void;
-  render(): React.Node;
-}
-declare export default typeof ButtonGroup;

package/dist/components/constants.js.flow

@@ -1,13 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare export var devices: {|
-  +PHONE: "phone",
-  +TABLET: "tablet",
-  +DESKTOP: "desktop",
-|};
-declare export var lintGutterWidth: 36;
-declare export var perseusFrameBorderWidth: 1;

package/dist/components/fixed-to-responsive.js.flow

@@ -1,34 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as React from "react";
-declare type Props = {|
-  width: number,
-  height: number,
-  children: React.Node,
-  className?: string,
-  constrainHeight?: boolean,
-  allowFullBleed?: boolean,
-|};
-declare type DefaultProps = {|
-  className: $PropertyType<Props, "className">,
-  constrainHeight: $PropertyType<Props, "constrainHeight">,
-  allowFullBleed: $PropertyType<Props, "allowFullBleed">,
-|};
-declare type State = {|
-  viewportHeight: number | null,
-  viewportWidth: number | null,
-|};
-declare class FixedToResponsive extends React.Component<Props, State> {
-  _isMounted: boolean;
-  static defaultProps: DefaultProps;
-  state: State;
-  componentDidMount(): void;
-  componentWillUnmount(): void;
-  _cacheViewportSize: () => void;
-  render(): React$Node;
-}
-declare export default typeof FixedToResponsive;

package/dist/components/graph.js.flow

@@ -1,66 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as React from "react";
-import type { Coord } from "../interactive2/types";
-import type { PerseusImageBackground } from "../perseus-types";
-declare type Props = {|
-  box: $ReadOnly<[number, number]>,
-  labels: $ReadOnlyArray<string>,
-  range: $ReadOnly<[Coord, Coord]>,
-  step: $ReadOnly<[number, number]>,
-  gridStep: $ReadOnly<[number, number]>,
-  snapStep: $ReadOnly<[number, number]>,
-  markings: string,
-  backgroundImage: PerseusImageBackground,
-  showProtractor: boolean,
-  showRuler: boolean,
-  rulerLabel: string,
-  rulerTicks: number,
-  instructions?: string,
-  isMobile: boolean,
-  onGraphieUpdated?: (graphie: any) => void,
-  onClick?: (Coord: any) => void,
-  onMouseDown?: (Coord: any) => void,
-  onMouseUp?: (Coord: any) => void,
-  onMouseMove?: (Coord: any) => void,
-  setDrawingAreaAvailable?: (boolean: any) => void,
-|};
-declare type DefaultProps = {|
-  labels: $PropertyType<Props, "labels">,
-  range: $PropertyType<Props, "range">,
-  step: $PropertyType<Props, "step">,
-  gridStep: $PropertyType<Props, "gridStep">,
-  snapStep: $PropertyType<Props, "snapStep">,
-  markings: $PropertyType<Props, "markings">,
-  backgroundImage: $PropertyType<Props, "backgroundImage">,
-  showProtractor: $PropertyType<Props, "showProtractor">,
-  showRuler: $PropertyType<Props, "showRuler">,
-  rulerLabel: $PropertyType<Props, "rulerLabel">,
-  rulerTicks: $PropertyType<Props, "rulerTicks">,
-  isMobile: $PropertyType<Props, "isMobile">,
-|};
-declare class Graph extends React.Component<Props> {
-  protractor: any;
-  ruler: any;
-  _graphie: any;
-  _hasSetupGraphieThisUpdate: boolean;
-  _shouldSetupGraphie: boolean;
-  static defaultProps: DefaultProps;
-  componentDidMount(): void;
-  UNSAFE_componentWillReceiveProps(nextProps: any): void;
-  componentDidUpdate(): void;
-  reset: () => void;
-  graphie: () => any;
-  pointsFromNormalized: (arg1: any, arg2: any) => any;
-  _setupGraphie: (arg1: any) => void;
-  _getGridConfig: () => any;
-  _updateProtractor: () => void;
-  _updateRuler: () => void;
-  toJSON: () => any;
-  render(): React.Node;
-}
-declare export default typeof Graph;

package/dist/components/graphie-classes.js.flow

@@ -1,19 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * A base class for all Graphie Movables
- *
- * Used for checking that all Graphie children are, in fact,
- * GraphieMovables
- */
-declare function GraphieMovable(descriptor: any): void;
-declare var _default: {|
-  GraphieMovable: typeof GraphieMovable,
-  createClass: (spec: any) => any,
-  createSimpleClass: (addFunction: any) => any,
-|};
-declare export default typeof _default;

package/dist/components/graphie-movables.js.flow

@@ -1,22 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare var _default: {|
-  Arc: any,
-  Circle: any,
-  Label: any,
-  Line: any,
-  MovableLine: any,
-  MovablePoint: any,
-  Parabola: any,
-  Path: any,
-  Plot: any,
-  PlotParametric: any,
-  Point: any,
-  Sinusoid: any,
-  Rect: any,
-|};
-declare export default typeof _default;

package/dist/components/graphie.js.flow

@@ -1,69 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as React from "react";
-import type { Coord } from "../interactive2/types";
-import type { Range, Size } from "../perseus-types";
-declare type Props = {|
-  addMouseLayer?: boolean,
-  box: Size,
-  range: [Coord, Coord],
-  ranges?: [Range, Range],
-  gridStep?: [number, number],
-  step?: [number, number],
-  scale?: [number, number],
-  isMobile?: boolean,
-  responsive?: boolean,
-  children?: React.Node,
-  options: any,
-  setDrawingAreaAvailable?: (boolean: any) => void,
-  setup: (
-    graphie: any,
-    options: {|
-      range: [Coord, Coord],
-      scale: [number, number],
-    |}
-  ) => void,
-  onClick?: (at: Coord) => void,
-  onMouseDown?: (at: Coord) => void,
-  onMouseMove?: (at: Coord) => void,
-  onMouseUp?: (at: Coord) => void,
-|};
-declare type DefaultProps = {|
-  range: $PropertyType<Props, "range">,
-  options: $PropertyType<Props, "options">,
-  responsive: $PropertyType<Props, "responsive">,
-  addMouseLayer: $PropertyType<Props, "addMouseLayer">,
-|};
-declare class Graphie extends React.Component<Props> {
-  graphieDivRef: React.RefObject<HTMLDivElement>;
-  static defaultProps: DefaultProps;
-  componentDidMount(): void;
-  shouldComponentUpdate(nextProps: Props): boolean;
-  componentDidUpdate(prevProps: Props): void;
-
-  /**
-   * Allow parents of the <Graphie> component to grab a reference to the
-   * underlying graphie object using
-   * `this.refs.graphieComponent.getGraphie()`
-   *
-   * This shouldn't be necessary for 90% of cases, but the power is there.
-   * Use it for good and not evil.
-   */
-  getGraphie: () => any;
-  _range: () => [Coord, Coord];
-  _box: () => Size;
-  _scale: () => $ReadOnlyArray<number>;
-  _setupGraphie: () => void;
-  _removeMovables: () => void;
-  _renderMovables: (
-    children: $ReadOnlyArray<any>,
-    arg2: any
-  ) => React.Element<any>;
-  _updateMovables: () => void;
-  render(): React.Node;
-}
-declare export default typeof Graphie;

package/dist/components/highlighting/highlightable-content.js.flow

@@ -1,56 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as React from "react";
-import type {
-  DOMHighlight,
-  DOMHighlightSet,
-  SerializedHighlightSet,
-  DOMRange,
-} from "./types";
-declare type Props = {|
-  children?: React.Element<any>,
-  editable: boolean,
-  enabled: boolean,
-  onSerializedHighlightsUpdate: (
-    serializedHighlights: SerializedHighlightSet
-  ) => mixed,
-  serializedHighlights: SerializedHighlightSet,
-|};
-declare type State = {|
-  wordRanges: $ReadOnlyArray<DOMRange>,
-|};
-declare class HighlightableContent extends React.PureComponent<Props, State> {
-  _container: HTMLElement | null | void;
-  _content: HTMLElement | null | void;
-  state: State;
-  _buildHighlight(highlightRange: DOMRange): DOMHighlight | null | void;
-
-  /**
-   * Take the highlights from props, and deserialize them into DOMHighlights,
-   * according to the latest cache of word ranges.
-   */
-  _getDOMHighlights(): DOMHighlightSet;
-
-  /**
-   * Add the given DOMHighlight to the current set.
-   */
-  _handleAddHighlight: (highlight: DOMHighlight) => void;
-
-  /**
-   * Remove the given highlight from the list, and call our callback with the
-   * new set of highlights.
-   */
-  _handleRemoveHighlight: (keyToRemove: string) => void;
-
-  /**
-   * When our WordIndexer sends us a new cache of word ranges, store it in
-   * our component state.
-   */
-  _handleWordsUpdate: (wordRanges: $ReadOnlyArray<DOMRange>) => void;
-  render(): React.Node;
-}
-declare export default typeof HighlightableContent;

package/dist/components/highlighting/highlights.js.flow

@@ -1,54 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import type {
-  DOMHighlight,
-  DOMHighlightSet,
-  SerializedHighlight,
-  DOMRange,
-} from "./types";
-
-/**
- * Given a list of DOMHighlights, return a new list that also includes the
- * given DOMRange as a new DOMHighlight. If the DOMHighlight intersects
- * existing DOMHighlights, the other Highlights are removed and their ranges
- * are merged into the new DOMHighlight.
- */
-declare export function addHighlight(
-  existingHighlights: DOMHighlightSet,
-  newHighlight: DOMHighlight
-): DOMHighlightSet;
-
-/**
- * Given a DOMRange and a list of word ranges, build a corresponding
- * DOMHighlight.
- *
- * If the DOMRange is not a valid highlight given the word ranges, return null.
- */
-declare export function buildHighlight(
-  existingHighlights: DOMHighlightSet,
-  wordRanges: $ReadOnlyArray<DOMRange>,
-  newHighlightRange: DOMRange
-): DOMHighlight | null | void;
-
-/**
- * Given a SerializedHightlight and the current set of word ranges, return a
- * DOMHighlight representing the SerializedHighlight.
- *
- * If the SerializedHighlight is not valid given the list of word ranges, throw
- * an error.
- */
-declare export function deserializeHighlight(
-  serializedHighlight: SerializedHighlight,
-  wordRanges: $ReadOnlyArray<DOMRange>
-): DOMHighlight;
-
-/**
- * Return a SerializedHighlight representing the given DOMHighlight.
- */
-declare export function serializeHighlight(
-  highlight: DOMHighlight
-): SerializedHighlight;

package/dist/components/highlighting/ranges.js.flow

@@ -1,60 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import type { DOMRange } from "./types";
-
-/**
- * Given two DOMRanges, return a DOMRange whose start point comes from A, and
- * whose end point comes from B.
- */
-declare export function spanRanges(a: DOMRange, b: DOMRange): DOMRange;
-
-/**
- * Given two DOMRanges, return whether they overlap.
- *
- * We here treat ranges like closed intervals: the boundary points are
- * considered to be included in the range, and, if a ends exactly where b
- * starts, they are considered to overlap.
- */
-declare export function rangesOverlap(a: DOMRange, b: DOMRange): boolean;
-
-/**
- * Given two DOMRanges, return whether the first includes the second: whether
- * all points that B contains are also contained by A.
- */
-declare export function rangeIncludes(a: DOMRange, b: DOMRange): boolean;
-
-/**
- * Given two DOMRanges, intersect them: return a range that contains all points
- * that both A contains and B contains, and contains no other points.
- *
- * If A and B do not overlap, no intersection exists; return null.
- */
-declare export function intersectRanges(
-  a: DOMRange,
-  b: DOMRange
-): DOMRange | null | void;
-
-/**
- * Given two DOMRanges, union them: return a range that contains all points
- * that either A contains or B contains, and contains no other points.
- *
- * If A and B do not overlap, no union exists; return null.
- */
-declare export function unionRanges(
-  a: DOMRange,
-  b: DOMRange
-): DOMRange | null | void;
-
-/**
- * Given a list of word ranges, and a selection range, binary search the list
- * and return the indexes of the first and last words that the selection
- * intersects, or `null` if the range includes no words.
- */
-declare export function findFirstAndLastWordIndexes(
-  selectionRange: DOMRange,
-  wordRanges: $ReadOnlyArray<DOMRange>
-): [number, number] | null | void;

package/dist/components/highlighting/types.js.flow

@@ -1,70 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * A range of highlightable content, defined relative to the current DOM.
- *
- * This is actually just the built-in DOM type Range, aliased for consistency
- * with DOMHighlight and SerializedHighlight.
- * https://developer.mozilla.org/en-US/docs/Web/API/Range
- *
- * A DOMRange is inherently coupled to a particular DOM session, and must be
- * serialized into a SerializedRange before being persisted.
- */
-export type DOMRange = Range;
-/**
- * A range of highlightable content, serialized into a DOM-independent format
- * so that it can be restored in subsequent browser sessions.
- *
- * We currently serialize ranges by the index of the first highlighted word and
- * index of the last highlighted word, each with respect to the full body of
- * the highlightable content.
- *
- * TODO(mdr): Word index serialization is fragile in environments where the
- *     highlightable content is liable to change. Currently, our only call
- *     sites is the test prep app, which saves Perseus state against a
- *     particular *version* of a Perseus item, so it's impossible for the
- *     content to change - but, if we try to generalize further, we'll need to
- *     create new types of range serialization that are more robust to change.
- *     (Maybe some quoted text, and we scan the content for matches?)
- *
- *     Note, too, that changes to the definition of "word" are liable to break
- *     already-persisted word-index ranges, too. If we significantly change the
- *     definition, we should consider adding a versioning field here - even if
- *     we don't support *all* historical word implementations, we still might
- *     want to hide old highlights altogether if our word definition has
- *     changed sufficiently radically.
- */
-export type SerializedRange = {|
-  type: "word-indexes",
-  firstWordIndex: number,
-  lastWordIndex: number,
-|};
-/**
- * A highlight, defined relative to the current DOM.
- *
- * A DOMHighlight, by depending on DOMRange, is inherently coupled to a
- * particular DOM session, and must be serialized into a SerializedRange before
- * being persisted.
- */
-export type DOMHighlight = {|
-  firstWordIndex: number,
-  lastWordIndex: number,
-  domRange: DOMRange,
-|};
-export type DOMHighlightSet = {
-  [key: string]: DOMHighlight,
-};
-/**
- * A highlight, serialized into a DOM-independent format so that it can be
- * restored in subsequent browser sessions.
- */
-export type SerializedHighlight = {|
-  range: SerializedRange,
-|};
-export type SerializedHighlightSet = {
-  [key: string]: SerializedHighlight,
-};