@khanacademy/perseus 7.2.1 → 8.0.0

package/dist/types.js.flow

@@ -1,318 +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 { SerializedHighlightSet } from "./components/highlighting/types";
-import type { ILogger } from "./logging/log";
-import type { Item } from "./multi-items/item-types";
-import type { PerseusWidget } from "./perseus-types";
-import type { SizeClass } from "./util/sizing-utils";
-import type { SendEventFn } from "@khanacademy/perseus-core";
-import type { Result } from "@khanacademy/wonder-blocks-data";
-export type FocusPath = $ReadOnlyArray<string> | null | void;
-export type Dimensions = {|
-  width?: number,
-  height?: number,
-|};
-export type DeviceType = "phone" | "tablet" | "desktop";
-export type Widget = any;
-export type WidgetDict = {
-  [name: string]: Widget,
-};
-export type ImageDict = {
-  [url: string]: Dimensions,
-};
-export type PerseusScore =
-  | {|
-      type: "invalid",
-      message?: string | null | void,
-      suppressAlmostThere?: boolean | null | void,
-    |}
-  | {|
-      type: "points",
-      earned: number,
-      total: number,
-      message?: string | null | void,
-    |};
-export type Hint = {|
-  widgets: WidgetDict,
-  content: string,
-  images: ImageDict,
-  replace?: boolean,
-|};
-export type Version = {|
-  major: number,
-  minor: number,
-|};
-export type EditorMode = "edit" | "preview" | "json";
-export type ChoiceState = {|
-  selected: boolean,
-  crossedOut: boolean,
-  highlighted: boolean,
-  rationaleShown: boolean,
-  correctnessShown: boolean,
-  previouslyAnswered: boolean,
-  readOnly: boolean,
-|};
-export type ChangeHandler = (
-  arg1: {|
-    hints?: $ReadOnlyArray<Hint>,
-    replace?: boolean,
-    content?: string,
-    widgets?: WidgetDict,
-    images?: ImageDict,
-    question?: any,
-    answerArea?: any,
-    itemDataVersion?: Version,
-    item?: Item,
-    editorMode?: EditorMode,
-    jsonMode?: boolean,
-    value?: any,
-    choiceStates?: $ReadOnlyArray<ChoiceState>,
-    currentValue?: string,
-    selected?: number,
-    tools?: $ReadOnlyArray<any>,
-    transformations?: $ReadOnlyArray<any>,
-    highlights?: SerializedHighlightSet,
-    plot?: any,
-  |},
-  callback?: () => mixed | null | void,
-  silent?: boolean
-) => mixed;
-export type ImageUploader = (
-  file: string,
-  callback: (url: string) => mixed
-) => mixed;
-export type WidgetSize = "normal" | "small" | "mini";
-export type Path = $ReadOnlyArray<string>;
-declare type StubTagEditorType = any;
-export type APIOptions = $ReadOnly<{|
-  isArticle?: boolean,
-  onInputError?: (
-    widgetId: any,
-    value: string,
-    message?: string | null | void
-  ) => mixed,
-  onFocusChange?: (
-    newFocusPath: FocusPath,
-    oldFocusPath: FocusPath,
-    keypadElement?: HTMLElement,
-    focusedElement?: HTMLElement
-  ) => mixed,
-  GroupMetadataEditor?: React.ComponentType<StubTagEditorType>,
-  showAlignmentOptions?: boolean,
-  readOnly?: boolean,
-  answerableCallback?: (arg1: boolean) => mixed,
-  getAnotherHint?: () => mixed,
-  interactionCallback?: () => mixed,
-  groupAnnotator?: (groupNumber: number, widgetId: string) => React.Node,
-  imagePlaceholder?: React.Node,
-  widgetPlaceholder?: React.Node,
-  baseElements?: {|
-    Link: React.ComponentType<any>,
-  |},
-  imagePreloader?: (dimensions: Dimensions) => React.Node,
-  trackInteraction?: (args: {|
-    ...{|
-      type: string,
-      id: string,
-      correct?: boolean,
-    |},
-    ...{ [key: string]: mixed },
-  |}) => void,
-  customKeypad?: boolean,
-  useV2Keypad?: boolean,
-  nativeKeypadProxy?: () => mixed,
-  isMobile?: boolean,
-  setDrawingAreaAvailable?: (arg1: boolean) => mixed,
-  useDraftEditor?: boolean,
-  hintProgressColor?: string,
-  canScrollPage?: boolean,
-  inModal?: boolean,
-  crossOutEnabled?: boolean,
-  editorChangeDelay?: number,
-|}>;
-declare type TeXProps = {|
-  children: string,
-  katexOptions?: any,
-  onClick?: () => mixed,
-  onRender?: (root?: any) => mixed,
-  style?: any,
-|};
-export type DomInsertCheckFn = (
-  text: string,
-  node: HTMLElement,
-  attribute?: string,
-  jiptString?: string
-) => string | false;
-export type JIPT = {|
-  useJIPT: boolean,
-|};
-export type JiptLabelStore = {|
-  addLabel: (label?: any, useMath?: any) => void,
-|};
-export interface JiptRenderer {
-  replaceJiptContent: (content: string, paragraphIndex: number) => void;
-}
-export type JiptTranslationComponents = {|
-  addComponent: (renderer: JiptRenderer) => number,
-  removeComponentAtIndex: (index: number) => void,
-|};
-export type VideoData = {|
-  __typename: "Video",
-  id: string,
-  title: string | null | void,
-
-  /**
-   * Unique identifier on YouTube.
-   * If this is a dubbed video, this is always the original English version on
-   * YouTube. If the localized version is needed, use translatedYoutubeId.
-   * Example: KL6sMOn7ULo
-   */
-  youtubeId: string | null | void,
-  contentId: string | null | void,
-|};
-declare interface StaticUrlFn {
-  (maybeRelativeUrl: string): string;
-  (maybeRelativeUrl?: void | null | void): void | null | void;
-}
-declare type InitialRequestUrlInterface = {|
-  origin: string,
-  host: string,
-  protocol: string,
-|};
-export type VideoKind = "YOUTUBE_ID" | "READABLE_ID";
-export type PerseusDependencies = {|
-  JIPT: JIPT,
-  graphieMovablesJiptLabels: JiptLabelStore,
-  svgImageJiptLabels: JiptLabelStore,
-  rendererTranslationComponents: JiptTranslationComponents,
-  TeX: React.ComponentType<TeXProps>,
-  staticUrl: StaticUrlFn,
-  InitialRequestUrl: InitialRequestUrlInterface,
-  analytics: SendEventFn,
-  useVideo(
-    id: string,
-    kind: VideoKind
-  ): Result<{|
-    video: VideoData | null | void,
-  |}>,
-  Log: ILogger,
-  isDevServer: boolean,
-  kaLocale: string,
-  isMobile: boolean,
-|};
-export type APIOptionsWithDefaults = $ReadOnly<{|
-  ...APIOptions,
-  ...{|
-    GroupMetadataEditor: $NonMaybeType<
-      $PropertyType<APIOptions, "GroupMetadataEditor">
-    >,
-    baseElements: $NonMaybeType<$PropertyType<APIOptions, "baseElements">>,
-    canScrollPage: $NonMaybeType<$PropertyType<APIOptions, "canScrollPage">>,
-    crossOutEnabled: $NonMaybeType<
-      $PropertyType<APIOptions, "crossOutEnabled">
-    >,
-    editorChangeDelay: $NonMaybeType<
-      $PropertyType<APIOptions, "editorChangeDelay">
-    >,
-    groupAnnotator: $NonMaybeType<$PropertyType<APIOptions, "groupAnnotator">>,
-    inModal: $NonMaybeType<$PropertyType<APIOptions, "inModal">>,
-    isArticle: $NonMaybeType<$PropertyType<APIOptions, "isArticle">>,
-    isMobile: $NonMaybeType<$PropertyType<APIOptions, "isMobile">>,
-    useV2Keypad: $NonMaybeType<$PropertyType<APIOptions, "useV2Keypad">>,
-    onFocusChange: $NonMaybeType<$PropertyType<APIOptions, "onFocusChange">>,
-    onInputError: $NonMaybeType<$PropertyType<APIOptions, "onInputError">>,
-    readOnly: $NonMaybeType<$PropertyType<APIOptions, "readOnly">>,
-    setDrawingAreaAvailable: $NonMaybeType<
-      $PropertyType<APIOptions, "setDrawingAreaAvailable">
-    >,
-    showAlignmentOptions: $NonMaybeType<
-      $PropertyType<APIOptions, "showAlignmentOptions">
-    >,
-    useDraftEditor: $NonMaybeType<$PropertyType<APIOptions, "useDraftEditor">>,
-  |},
-|}>;
-export type LinterContextProps = {|
-  contentType: string,
-  highlightLint: boolean,
-  paths: $ReadOnlyArray<string>,
-  stack: $ReadOnlyArray<string>,
-|};
-export type Tracking = "" | "all";
-export type Alignment =
-  | "default"
-  | "block"
-  | "inline-block"
-  | "inline"
-  | "float-left"
-  | "float-right"
-  | "full-width";
-declare type WidgetOptions = any;
-export type WidgetTransform = (
-  arg1: WidgetOptions,
-  problemNumber?: number
-) => any;
-export type WidgetExports<
-  T: React.ComponentType<any> = React.ComponentType<any>
-> = $ReadOnly<{|
-  name: string,
-  displayName: string,
-  getWidget?: () => T,
-  accessible?: boolean | ((props: any) => boolean),
-  hidden?: boolean,
-  version?: Version,
-  supportedAlignments?: $ReadOnlyArray<Alignment>,
-  defaultAlignment?: Alignment,
-  getDefaultAlignment?: () => Alignment,
-  isLintable?: boolean,
-  tracking?: Tracking,
-  traverseChildWidgets?: any,
-  transform?: WidgetTransform,
-  staticTransform?: WidgetTransform,
-  propUpgrades?: {
-    [key: string]: (arg1: any) => any,
-  },
-  widget: T,
-|}>;
-export type WidgetInfo = PerseusWidget;
-export type FilterCriterion =
-  | string
-  | ((
-      id: string,
-      widgetInfo: WidgetInfo,
-      widget?: Widget | null | void
-    ) => boolean);
-export type WidgetProps<RenderProps, Rubric> = {|
-  ...RenderProps,
-  ...{|
-    widgetId: string,
-    alignment: string | null | void,
-    static: boolean | null | void,
-    problemNum: number | null | void,
-    apiOptions: APIOptionsWithDefaults,
-    keypadElement?: any,
-    questionCompleted?: boolean,
-    onFocus: (blurPath: FocusPath) => void,
-    onBlur: (blurPath: FocusPath) => void,
-    findWidgets: (arg1: FilterCriterion) => $ReadOnlyArray<Widget>,
-    reviewModeRubric: Rubric,
-    onChange: ChangeHandler,
-    trackInteraction: (extraData?: any) => void,
-    isLastUsedWidget: boolean,
-    linterContext: LinterContextProps,
-    containerSizeClass: SizeClass,
-  |},
-|};
-export type ChangeFn = (
-  newPropsOrSinglePropName:
-    | string
-    | {
-        [key: string]: any,
-      },
-  propValue?: any,
-  callback?: () => mixed
-) => any | null | void;

package/dist/util/a11y.js.flow

@@ -1,8 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare var _default: StyleDeclaration;
-declare export default typeof _default;

package/dist/util/answer-types.js.flow

@@ -1,49 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare type Guess = any;
-declare type Predicate = any;
-declare type Score = {|
-  empty: boolean,
-  correct: boolean,
-  message: string | null | void,
-  suppressAlmostThere?: boolean | null | void,
-  guess: Guess,
-  ungraded?: boolean,
-|};
-declare export var errors: {|
-  +APPROXIMATED_PI_ERROR: string,
-  +EXTRA_SYMBOLS_ERROR: string,
-  +NEEDS_TO_BE_SIMPLFIED_ERROR: string,
-  +MISSING_PERCENT_ERROR: string,
-  +MULTIPLICATION_SIGN_ERROR: string,
-  +WRONG_CASE_ERROR: string,
-  +WRONG_LETTER_ERROR: string,
-|};
-declare var KhanAnswerTypes: {|
-  +predicate: {|
-    +defaultForms: "integer, proper, improper, mixed, decimal",
-    +createValidatorFunctional: (
-      predicate: Predicate,
-      options: any
-    ) => (arg1: Guess) => Score,
-  |},
-  +number: {|
-    +convertToPredicate: (correctAnswer: string, options: any) => Predicate,
-    +createValidatorFunctional: (
-      correctAnswer: string,
-      options: any
-    ) => (arg1: Guess) => Score,
-  |},
-  +expression: {|
-    +parseSolution: (solutionString: string, options: any) => any,
-    +createValidatorFunctional: (
-      solution: any,
-      options: any
-    ) => (arg1: Guess) => Score,
-  |},
-|};
-declare export default typeof KhanAnswerTypes;

package/dist/util/colors.js.flow

@@ -1,95 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * Color constants we use throughout Perseus (originally on KhanUtil).
- *
- * Note that if the color palette changes substantially, it may also need to be
- * updated in khan-exercises and cherry-picked into graphie-to-png's
- * khan-exercises submodule, as graphie-to-png still relies on the palette
- * provided on KhanUtil.
- */
-declare var KhanColors: {|
-  +BLUE: "#6495ED",
-  +ORANGE: "#FFA500",
-  +PINK: "#FF00AF",
-  +GREEN: "#28AE7B",
-  +PURPLE: "#9D38BD",
-  +RED: "#DF0030",
-  +GRAY: "gray",
-  +BLACK: "black",
-  +LIGHT_BLUE: "#9AB8ED",
-  +LIGHT_ORANGE: "#EDD19B",
-  +LIGHT_PINK: "#ED9BD3",
-  +LIGHT_GREEN: "#9BEDCE",
-  +LIGHT_PURPLE: "#DA9BED",
-  +LIGHT_RED: "#ED9AAC",
-  +LIGHT_GRAY: "#ED9B9B",
-  +LIGHT_BLACK: "#ED9B9B",
-  +GRAY10: "#D6D6D6",
-  +GRAY20: "#CDCDCD",
-  +GRAY30: "#B3B3B3",
-  +GRAY40: "#9A9A9A",
-  +GRAY50: "#808080",
-  +GRAY60: "#666666",
-  +GRAY70: "#4D4D4D",
-  +GRAY80: "#333333",
-  +GRAY90: "#1A1A1A",
-  +BLUE_A: "#CCFAFF",
-  +BLUE_B: "#80F6FF",
-  +BLUE_C: "#63D9EA",
-  +BLUE_D: "#11ACCD",
-  +BLUE_E: "#0C7F99",
-  +TEAL_A: "#94FFF5",
-  +TEAL_B: "#26EDD5",
-  +TEAL_C: "#01D1C1",
-  +TEAL_D: "#01A995",
-  +TEAL_E: "#208170",
-  +GREEN_A: "#B6FFB0",
-  +GREEN_B: "#8AF281",
-  +GREEN_C: "#74CF70",
-  +GREEN_D: "#1FAB54",
-  +GREEN_E: "#0D923F",
-  +GOLD_A: "#FFD0A9",
-  +GOLD_B: "#FFBB71",
-  +GOLD_C: "#FF9C39",
-  +GOLD_D: "#E07D10",
-  +GOLD_E: "#A75A05",
-  +RED_A: "#FCA9A9",
-  +RED_B: "#FF8482",
-  +RED_C: "#F9685D",
-  +RED_D: "#E84D39",
-  +RED_E: "#BC2612",
-  +MAROON_A: "#FFBDE0",
-  +MAROON_B: "#FF92C6",
-  +MAROON_C: "#ED5FA6",
-  +MAROON_D: "#CA337C",
-  +MAROON_E: "#9E034E",
-  +PURPLE_A: "#DDD7FF",
-  +PURPLE_B: "#C6B9FC",
-  +PURPLE_C: "#AA87FF",
-  +PURPLE_D: "#7854AB",
-  +PURPLE_E: "#543B78",
-  +MINT_A: "#F5F9E8",
-  +MINT_B: "#EDF2DF",
-  +MINT_C: "#E0E5CC",
-  +GRAY_A: "#F6F7F7",
-  +GRAY_B: "#F0F1F2",
-  +GRAY_C: "#E3E5E6",
-  +GRAY_D: "#D6D8DA",
-  +GRAY_E: "#BABEC2",
-  +GRAY_F: "#888D93",
-  +GRAY_G: "#626569",
-  +GRAY_H: "#3B3E40",
-  +GRAY_I: "#21242C",
-  +KA_BLUE: "#314453",
-  +KA_GREEN: "#71B307",
-  +_BACKGROUND: "#FDFDFD",
-  +INTERACTING: "#71B307",
-  +INTERACTIVE: "#71B307",
-  +DYNAMIC: "#6495ED",
-|};
-declare export default typeof KhanColors;

package/dist/util/fix-passage-refs.js.flow

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

package/dist/util/geometry.js.flow

@@ -1,37 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import type { Coord, Line } from "../interactive2/types";
-export type Range = [number, number];
-export type SineCoefficient = [number, number, number, number];
-export type QuadraticCoefficient = [number, number, number];
-declare export function sign(val: number): 0 | 1 | -1;
-declare export function ccw(a: Coord, b: Coord, c: Coord): number;
-declare export function collinear(a: Coord, b: Coord, c: Coord): boolean;
-declare export function intersects(ab: Line, cd: Line): boolean;
-declare export function vector(a: any, b: any): number[];
-declare export function magnitude(v: $ReadOnlyArray<Coord>): number;
-declare export function angleMeasures(
-  coords: $ReadOnlyArray<Coord>
-): $ReadOnlyArray<number>;
-declare export function similar(
-  coords1: $ReadOnlyArray<Coord>,
-  coords2: $ReadOnlyArray<Coord>,
-  tolerance: number
-): boolean;
-declare export function lawOfCosines(a: number, b: number, c: number): number;
-declare export function canonicalSineCoefficients(
-  x: [any, any, any, any]
-): any[];
-declare export function rotate<T>(
-  array: $ReadOnlyArray<T>,
-  n?: number
-): $ReadOnlyArray<T>;
-declare export function getLineEquation(first: Coord, second: Coord): string;
-declare export function getLineIntersection(
-  firstPoints: $ReadOnlyArray<Coord>,
-  secondPoints: $ReadOnlyArray<Coord>
-): string;

package/dist/util/graph-utils.js.flow

@@ -1,9 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import GraphUtils from "./graphie";
-import "./interactive";
-declare export default typeof GraphUtils;

package/dist/util/graphie.js.flow

@@ -1,8 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare var GraphUtils: any;
-declare export default typeof GraphUtils;

package/dist/util/interactive.js.flow

@@ -1,11 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import "../jquery.mobile.vmouse";
-import type { Coord } from "../interactive2/types";
-export type MouseHandler = (position: Coord) => void;
-declare var InteractiveUtils: any;
-declare export default typeof InteractiveUtils;

package/dist/util/katex-preprocess.js.flow

@@ -1,12 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * Preprocess TeX code to convert things that KaTeX doesn't know how to handle
- * to things is does.
- */
-declare var _default: (texCode: string) => string;
-declare export default typeof _default;

package/dist/util/math.js.flow

@@ -1,62 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import type { MathFormat } from "../perseus-types";
-declare var KhanMath: {|
-  +cleanMath: (expr: string) => string,
-  +bound: (num: number) => number,
-  +factorial: (x: number) => number,
-  +getGCD: (a: number, b: number) => number,
-  +getLCM: (a: number, b: number) => number,
-  +primes: [
-    2,
-    3,
-    5,
-    7,
-    11,
-    13,
-    17,
-    19,
-    23,
-    29,
-    31,
-    37,
-    41,
-    43,
-    47,
-    53,
-    59,
-    61,
-    67,
-    71,
-    73,
-    79,
-    83,
-    89,
-    97
-  ],
-  +isPrime: (n: number) => boolean,
-  +getPrimeFactorization: (number: number) => $ReadOnlyArray<number>,
-  +roundToNearest: (increment: number, num: number) => number,
-  +roundTo: (precision: number, num: number) => number,
-
-  /**
-   * Return a string of num rounded to a fixed precision decimal places,
-   * with an approx symbol if num had to be rounded, and trailing 0s
-   */
-  +toFixedApprox: (num: number, precision: number) => string,
-
-  /**
-   * Return a string of num rounded to precision decimal places, with an
-   * approx symbol if num had to be rounded, but no trailing 0s if it was
-   * not rounded.
-   */
-  +roundToApprox: (num: number, precision: number) => string,
-  +toFraction: (decimal: number, tolerance?: number) => [number, number],
-  +getNumericFormat: (text: string) => MathFormat | null | void,
-  +toNumericString: (number: number, format?: MathFormat) => string,
-|};
-declare export default typeof KhanMath;

package/dist/util/mobile-native-utils.js.flow

@@ -1,12 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * Helps us detect that we are running in a mobile native environment for
- * any js that is bundled in the mobile app (e.g. Perseus).
- * @param {*} protocol protocol portion of a URL. Generally: window.location.protocol
- */
-declare export var isFileProtocol: (protocol?: string | null) => boolean;

package/dist/util/react-render.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 export default function render<ElementType: React.ElementType<>>(
-  element: React.Node,
-  container: HTMLElement,
-  callback?: () => void
-): React.ElementRef<ElementType>;

package/dist/util/register-all-widgets-for-testing.js.flow

@@ -1,7 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare export var registerAllWidgetsForTesting: () => void;

package/dist/util/scroll-utils.js.flow

@@ -1,19 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * A small collection of useful scrolling utility functions.
- */
-/**
- * Scroll the given element into view.
- *
- * This works with elements inside scroll containers, but may fail in scenarios
- * involving multiple nested scroll containers.
- */
-declare export var scrollElementIntoView: (
-  element: Element,
-  callback?: any
-) => void;