@khanacademy/perseus 7.2.0 → 8.0.0

package/dist/interactive2/movable-polygon-options.js.flow

@@ -1,47 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import type { Coord } from "./types";
-declare var _default: {|
-  add: {|
-    +constrain: () => void,
-    +pointsToFront: (state: any) => void,
-  |},
-  modify: {|
-    +draw: () => void,
-  |},
-  draw: {|
-    +basic: (state: any, prevState: any) => void,
-    +labels: (state: any, prevState: any) => void,
-    +highlight: (state: any, prevState: any) => void,
-  |},
-  remove: {|
-    +basic: () => void,
-    +labels: () => void,
-  |},
-  onMoveStart: {|
-    standard: null,
-  |},
-  constraints: {|
-    +fixed: () => () => boolean,
-    +snap: (snap: any) => (arg1: Coord) => mixed,
-    +bound: (
-      range: any,
-      snap: any,
-      paddingPx: number
-    ) => (arg1: Coord, arg2: Coord) => Coord,
-  |},
-  onMove: {|
-    +updatePoints: (coord: Coord, prevCoord: Coord) => void,
-  |},
-  onMoveEnd: {|
-    standard: null,
-  |},
-  onClick: {|
-    standard: null,
-  |},
-|};
-declare export default typeof _default;

package/dist/interactive2/movable-polygon.js.flow

@@ -1,8 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare var MovablePolygon: (graphie: any, movable: any, options: any) => void;
-declare export default typeof MovablePolygon;

package/dist/interactive2/movable.js.flow

@@ -1,8 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare var Movable: (graphie: any, options: any) => void;
-declare export default typeof Movable;

package/dist/interactive2/objective_.js.flow

@@ -1,25 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * A work-in-progress of _ methods for objects.
- * That is, they take an object as a parameter,
- * and return an object instead of an array.
- *
- * TODO(aria): Move this out of interactive2
- */
-declare var _default: {|
-  pluck: (table: any, subKey: string) => any,
-  mapObject: <K: string, V, U>(
-    obj: $Rest<{ [key: K]: V }, {}>,
-    lambda: (arg1: V, arg2: K) => U
-  ) => $Rest<{ [key: K]: U }, {}>,
-  mapObjectFromArray: <K_1: string, V_1>(
-    arr: $ReadOnlyArray<K_1>,
-    lambda: (arg1: K_1) => V_1
-  ) => $Rest<{ [key: K_1]: V_1 }, {}>,
-|};
-declare export default typeof _default;

package/dist/interactive2/types.js.flow

@@ -1,8 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-export type Coord = [number, number];
-export type Line = [Coord, Coord];

package/dist/interactive2/wrapped-defaults.js.flow

@@ -1,11 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * Default methods for a wrapped movable.
- */
-declare var WrappedDefaults: any;
-declare export default typeof WrappedDefaults;

package/dist/interactive2/wrapped-ellipse.js.flow

@@ -1,14 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import type { Coord } from "./types";
-declare var WrappedEllipse: (
-  graphie: any,
-  center: Coord,
-  radii: [number, number],
-  options: any
-) => void;
-declare export default typeof WrappedEllipse;

package/dist/interactive2/wrapped-line.js.flow

@@ -1,14 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import type { Coord } from "./types";
-declare var WrappedLine: (
-  graphie: any,
-  start: Coord,
-  end: Coord,
-  options: any
-) => void;
-declare export default typeof WrappedLine;

package/dist/interactive2/wrapped-path.js.flow

@@ -1,13 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import type { Coord } from "./types";
-declare var WrappedPath: (
-  graphie: any,
-  points: $ReadOnlyArray<Coord>,
-  options: any
-) => void;
-declare export default typeof WrappedPath;

package/dist/interactive2.js.flow

@@ -1,16 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare var Interactive2: {|
-  +MovablePoint: (graphie: any, movable: any, options: any) => void,
-  +addMovablePoint: (graphie: any, options: any) => any,
-  +MovableLine: (graphie: any, movable: any, options: any) => void,
-  +addMovableLine: (graphie: any, options: any) => any,
-  +MovablePolygon: (graphie: any, movable: any, options: any) => void,
-  +addMovablePolygon: (graphie: any, options: any) => any,
-  +addMaybeMobileMovablePoint: (widget: any, extraProps: any) => any,
-|};
-declare export default typeof Interactive2;

package/dist/item-renderer.js.flow

@@ -1,132 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as React from "react";
-import HintsRenderer from "./hints-renderer";
-import Renderer from "./renderer";
-import type { KeypadProps } from "./mixins/provide-keypad";
-import type { PerseusItem } from "./perseus-types";
-import type { APIOptions, FocusPath, LinterContextProps } from "./types";
-import type { KEScore } from "@khanacademy/perseus-core";
-declare type Props = {|
-  ...KeypadProps,
-  ...{|
-    apiOptions: APIOptions,
-    controlPeripherals?: boolean,
-    workAreaSelector: string,
-    hintsAreaSelector: string,
-    initialHintsVisible?: number,
-    item: PerseusItem | any,
-    onShowCalculator?: () => mixed,
-    onShowChi2Table?: () => mixed,
-    onShowPeriodicTable?: () => mixed,
-    onShowTTable?: () => mixed,
-    onShowZTable?: () => mixed,
-    problemNum: number,
-    reviewMode: boolean,
-    savedState: any,
-    linterContext: LinterContextProps,
-    legacyPerseusLint?: $ReadOnlyArray<string>,
-  |},
-|};
-declare type DefaultProps = {|
-  apiOptions: $PropertyType<Props, "apiOptions">,
-  controlPeripherals: $PropertyType<Props, "controlPeripherals">,
-  hintsAreaSelector: $PropertyType<Props, "hintsAreaSelector">,
-  initialHintsVisible: $PropertyType<Props, "initialHintsVisible">,
-  linterContext: $PropertyType<Props, "linterContext">,
-  reviewMode: $PropertyType<Props, "reviewMode">,
-  workAreaSelector: $PropertyType<Props, "workAreaSelector">,
-|};
-declare type State = {|
-  keypadElement: HTMLElement | null | void,
-  hintsVisible: number,
-  questionCompleted: boolean,
-  questionHighlightedWidgets: $ReadOnlyArray<string>,
-|};
-declare type SerializedState = {|
-  hints: any,
-  question: {
-    [id: string]: any,
-  },
-|};
-declare class ItemRenderer extends React.Component<Props, State> {
-  questionRenderer: Renderer;
-  hintsRenderer: React.ElementRef<typeof HintsRenderer> | null | void;
-  _currentFocus: FocusPath;
-  static defaultProps: DefaultProps;
-  constructor(props: Props): this;
-  componentDidMount(): void;
-  UNSAFE_componentWillReceiveProps(nextProps: Props): void;
-  componentDidUpdate(): void;
-  componentWillUnmount(): void;
-  keypadElement(): any;
-  update(): void;
-  _handleFocusChange: (newFocus: FocusPath, oldFocus: FocusPath) => void;
-  _setCurrentFocus(newFocus: FocusPath): void;
-  _onRendererBlur(blurPath: FocusPath): void;
-
-  /**
-   * Accepts a question area widgetId, or an answer area widgetId of
-   * the form "answer-input-number 1", or the string "answer-area"
-   * for the whole answer area (if the answer area is a single widget).
-   */
-  _setWidgetProps(widgetId: string, newProps: any, callback: any): void;
-
-  /**
-   * Sets the input value into the widget found at `path`. The `focus`
-   * function provided is called when all affected widgets have been
-   * re-rendered with the new value.
-   */
-  setInputValue(path: FocusPath, newValue: string, focus: () => void): void;
-  focusPath(path: FocusPath): void;
-  blurPath(path: FocusPath): void;
-  getDOMNodeForPath(path: FocusPath): Element | Text | null | void;
-  getGrammarTypeForPath(path: FocusPath): string | null | void;
-  getInputPaths(): $ReadOnlyArray<FocusPath>;
-  handleInteractWithWidget: (widgetId: string) => void;
-  focus(): boolean | null | void;
-  blur(): void;
-  showHint(): void;
-  getNumHints(): number;
-
-  /**
-   * Grades the item.
-   *
-   * Returns a KE-style score of {
-   *     empty: bool,
-   *     correct: bool,
-   *     message: string|null,
-   *     guess: Array
-   * }
-   */
-  scoreInput(): KEScore;
-
-  /**
-   * Returns an array of all widget IDs in the order they occur in
-   * the question content.
-   */
-  getWidgetIds(): $ReadOnlyArray<string>;
-
-  /**
-   * Returns an object mapping from widget ID to KE-style score.
-   * The keys of this object are the values of the array returned
-   * from `getWidgetIds`.
-   */
-  scoreWidgets(): {
-    [id: string]: KEScore,
-  };
-
-  /**
-   * Get a representation of the current state of the item.
-   */
-  getSerializedState(): SerializedState;
-  restoreSerializedState(state: SerializedState, callback?: () => void): void;
-  showRationalesForCurrentlySelectedChoices(): void;
-  deselectIncorrectSelectedChoices(): void;
-  render(): React.Node;
-}
-declare export default typeof ItemRenderer;

package/dist/item-version.js.flow

@@ -1,11 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as $Flowgen$Import$_2e__2f_types from "./types";
-declare var ItemVersion: {
-  [key: string]: $Flowgen$Import$_2e__2f_types.Version,
-};
-declare export default typeof ItemVersion;

package/dist/jipt-paragraphs.js.flow

@@ -1,14 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * Paragraph parsing/splitting for article jipt i18n
- */
-declare var _default: {|
-  parseToArray: (source: string) => string[],
-  joinFromArray: (paragraphs: $ReadOnlyArray<string>) => string,
-|};
-declare export default typeof _default;

package/dist/loading-context.js.flow

@@ -1,12 +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 = {|
-  onRendered: (isRendered: boolean) => void,
-|};
-declare var context: React.Context<Context>;
-declare export default typeof context;

package/dist/logging/log.js.flow

@@ -1,62 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import type { Metadata } from "@khanacademy/wonder-stuff-core";
-
-/**
- * @typedef {Object} Errors utility for referencing the Perseus error taxonomy.
- */
-declare export var Errors: $ReadOnly<{|
-  /**
-   * @property {ErrorKind} Unknown The kind of error is not known.
-   */
-  Unknown: "Unknown",
-
-  /**
-   * @property {ErrorKind} Internal The error is internal to the executing code.
-   */
-  Internal: "Internal",
-
-  /**
-   * @property {ErrorKind} InvalidInput There was a problem with the provided
-   * input, such as the wrong format or a null value.
-   */
-  InvalidInput: "InvalidInput",
-
-  /**
-   * @property [object Object],[object Object],[object Object],[object Object],[object Object]
-   */
-  NotAllowed: "NotAllowed",
-
-  /**
-   * @property {ErrorKind} TransientService There was a problem when making a
-   * request to a service.
-   */
-  TransientService: "TransientService",
-
-  /**
-   * @property {ErrorKind} Service There was a non-transient problem when
-   * making a request to service.
-   */
-  Service: "Service",
-|}>;
-/**
- * @type {ErrorKind} The kind of error being reported
- */
-export type ErrorKind = $ElementType<typeof Errors, $Keys<typeof Errors>>;
-export type LogErrorOptions = {|
-  cause?: Error | null | void,
-  loggedMetadata?: Metadata | null | void,
-  metadata?: Metadata | null | void,
-|};
-/**
- * Provides logging infrastructure for Perseus
- */
-export interface ILogger {
-  log(message: string, extra?: Metadata | null | void): void;
-  error(message: string, kind: ErrorKind, extra?: LogErrorOptions): void;
-}
-declare export var Log: ILogger;

package/dist/mixins/changeable.js.flow

@@ -1,33 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import PropTypes from "prop-types";
-import type { ChangeFn } from "../types";
-
-/**
- * this.change()
- *
- * Can be called as follows:
- * this.change(newProps, callback);
- *
- * this.change(propName, propValue, callback);
- *
- * this.change(propName) -> returns a lambda that takes a prop value to
- * set and a callback to call after having set that value.
- */
-declare export var change: ChangeFn;
-declare export var propTypes: {|
-  +onChange: PropTypes.Validator<(...args: any[]) => any>,
-|};
-export type ChangeableProps = {|
-  onChange: (
-    values: {
-      [key: string]: any,
-    },
-    callback?: () => mixed | null | void,
-    silent?: boolean
-  ) => mixed,
-|};

package/dist/mixins/editor-jsonify.js.flow

@@ -1,10 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare var EditorJsonify: {|
-  +serialize: () => any,
-|};
-declare export default typeof EditorJsonify;

package/dist/mixins/provide-keypad.js.flow

@@ -1,33 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import PropTypes from "prop-types";
-import type { CSSProperties } from "aphrodite";
-export type KeypadProps = {|
-  keypadStyle?: CSSProperties,
-|};
-export type KeypadApiOptions = {|
-  customKeypad: boolean,
-  nativeKeypadProxy: any,
-|};
-declare var ProvideKeypad: {|
-  +propTypes: {|
-    +apiOptions: PropTypes.Requireable<
-      PropTypes.InferProps<{|
-        customKeypad: PropTypes.Requireable<boolean>,
-        nativeKeypadProxy: PropTypes.Requireable<(...args: any[]) => any>,
-      |}>
-    >,
-    +keypadStyle: PropTypes.Requireable<any>,
-  |},
-  +getInitialState: () => {|
-    keypadElement: any | null,
-  |},
-  +componentDidMount: () => void,
-  +componentWillUnmount: () => void,
-  +keypadElement: () => any,
-|};
-declare export default typeof ProvideKeypad;

package/dist/mixins/widget-jsonify-deprecated.js.flow

@@ -1,11 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare var WidgetJsonifyDeprecated: {|
-  +getUserInput: () => any,
-  +getUserInputFromProps: (props: any) => any,
-|};
-declare export default typeof WidgetJsonifyDeprecated;

package/dist/mixins/widget-prop-denylist.js.flow

@@ -1,20 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * These are things that widgets should exclude when serializing themselves.
- *
- * The use of this list needs to die. Basically, there are codepaths that
- * blindly serialize the "props" of a widget so that it can pass around its
- * info. Unfortunately, props aren't guaranteed to be serializable, and
- * automatically serializing schemaless list of attributes causes issues (e.g.
- * circular JSON structures sometimes).
- *
- * This blocks things that we know don't need to be serialized.
- */
-declare var denylist: string[];
-declare export var removeDenylistProps: (props: any) => any;
-declare export default typeof denylist;

package/dist/multi-items/item-types.js.flow

@@ -1,55 +0,0 @@
-// @flow
-/**
- * Type definitions for multi-item types, including:
- *
- * - Item: A multi-item tree wrapped in a `_multi` key, to help us recognize it
- *         as a multi-item in other contexts and avoid misinterpreting its
- *         other properties.
- * - ItemTree: A multi-item without the `_multi` key. Conforms to the Tree
- *             interface, so it's compatible with our tree traversal functions.
- * - And the various types of nodes that compose a tree.
- */
-import type {WidgetDict, ImageDict} from "../types.js";
-import type {Tree, ArrayNode, ObjectNode} from "./tree-types.js";
-
-export type ContentNode = {
-    // TODO(mdr): When we first drafted the multi-item feature, we named
-    //     content nodes "item" nodes, and later decided the term was
-    //     ambiguous and switched to "content". But we're temporarily keeping
-    //     support for the "item" string when inferring item shape, so that we
-    //     don't crash on multi-items we've already created - but all new
-    //     content nodes will be generated with the "content" string.
-    //
-    //     Code blocks that enable this legacy support are greppable with the
-    //     keyword #LegacyContentNode.
-    __type: "content" | "item",
-    // Perseus has default values for these fields, so they're all optional.
-    content?: ?string,
-    images?: ?ImageDict,
-    widgets?: ?WidgetDict,
-    ...
-};
-export type HintNode = {
-    __type: "hint",
-    // Perseus has default values for these fields, so they're all optional.
-    content?: ?string,
-    images?: ?ImageDict,
-    widgets?: ?WidgetDict,
-    replace?: ?boolean,
-    ...
-};
-export type TagsNode = $ReadOnlyArray<string>;
-
-export type ItemArrayNode = ArrayNode<ContentNode, HintNode, TagsNode>;
-export type ItemObjectNode = ObjectNode<ContentNode, HintNode, TagsNode>;
-export type ItemTree = Tree<ContentNode, HintNode, TagsNode>;
-
-// TODO(jeremy): I think we could refine this root type for multi items. Right
-// now a _multi's value can be _anything_ including "primitive" node types such
-// as "type: content" or "type: hint". That doesn't seem to match the shapes
-// that are in use to date. We could also move to a strict type at that point
-// because it appears that we _never_ add other root keys to an item that
-// specifies the `_multi` key. I think we'd be safe to restrict this root
-// object type to something like the following:
-// export type Item = {|_multi: ItemArrayNode | ItemObjectNode|};
-export type Item = {_multi: ItemTree, ...};

package/dist/multi-items/items.js.flow

@@ -1,66 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import type { Item, ItemTree, ContentNode, HintNode } from "./item-types";
-import type { Shape } from "./shape-types";
-
-/**
- * Return a semantically empty ItemTree that conforms to the given shape.
- *
- * - An empty content node has an empty content string and no widgets/images.
- * - An empty hint node has an empty content string and no widgets/images.
- * - An empty array node has no elements.
- * - An empty object node has a semantically empty node for each of its keys.
- *   (That is, we recursively call buildEmptyItemTreeForShape for each key.)
- */
-declare export function buildEmptyItemTreeForShape(shape: Shape): ItemTree;
-
-/**
- * Return a semantically empty Item that conforms to the given shape.
- *
- * - An empty content node has an empty content string and no widgets/images.
- * - An empty hint node has an empty content string and no widgets/images.
- * - An empty array node has no elements.
- * - An empty object node has a semantically empty node for each of its keys.
- *   (That is, we recursively call buildEmptyItemTreeForShape for each key.)
- */
-declare export function buildEmptyItemForShape(shape: Shape): Item;
-
-/**
- * Given an Item and its Shape, yield all of its content nodes to the callback.
- */
-declare export function findContentNodesInItem(
-  item: Item,
-  shape: Shape,
-  callback: (c: ContentNode) => any
-): void;
-
-/**
- * Given an Item and its Shape, yield all of its hint nodes to the callback.
- */
-declare export function findHintNodesInItem(
-  item: Item,
-  shape: Shape,
-  callback: (h: HintNode) => any
-): void;
-
-/**
- * Given an ItemTree, return a Shape that it conforms to.
- *
- * The Shape might not be complete or correct Shape that this Item was designed
- * for. If you have access to the intended Shape, use that instead.
- */
-declare export function inferItemShape(item: Item): Shape;
-
-/**
- * Convert the given Item to an ItemTree, by unwrapping the `_multi` key.
- */
-declare export function itemToTree(item: Item): ItemTree;
-
-/**
- * Convert the given ItemTree to an Item, by wrapping it in the `_multi` key.
- */
-declare export function treeToItem(node: ItemTree): Item;