@khanacademy/perseus 7.2.1 → 8.0.0

package/dist/question-paragraph.js.flow

@@ -1,17 +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 = {|
-  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.js.flow

@@ -1,19 +0,0 @@
-/**
- * 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.js.flow

@@ -1,325 +0,0 @@
-/**
- * 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,
-  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.Node;
-  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;

package/dist/server-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 Renderer from "./renderer";
-import type { KeypadProps } from "./mixins/provide-keypad";
-import type { APIOptions, FocusPath } from "./types";
-import type { RendererInterface, KEScore } from "@khanacademy/perseus-core";
-declare type OwnProps = {|
-  ...KeypadProps,
-  ...{|
-    apiOptions: APIOptions,
-    hintsVisible?: number,
-    item: {|
-      hints: $ReadOnlyArray<any>,
-      question: any,
-    |},
-    problemNum?: number,
-    reviewMode?: boolean,
-    keypadElement?: any | null | void,
-  |},
-|};
-declare type HOCProps = {|
-  onRendered: (isRendered: boolean) => void,
-|};
-declare type Props = {| ...OwnProps, ...HOCProps |};
-declare type DefaultProps = {|
-  apiOptions: $PropertyType<Props, "apiOptions">,
-  onRendered: $PropertyType<Props, "onRendered">,
-|};
-declare type State = {|
-  questionCompleted: boolean,
-  questionHighlightedWidgets: $ReadOnlyArray<any>,
-  assetStatuses: {
-    [assetKey: string]: boolean,
-  },
-|};
-declare type SerializedState = {|
-  question: any,
-  hints: any,
-|};
-declare export class ServerItemRenderer
-  extends React.Component<Props, State>
-  implements RendererInterface
-{
-  questionRenderer: Renderer;
-  hintsRenderer: any;
-  _currentFocus: FocusPath;
-  _fullyRendered: boolean;
-  blurTimeoutID: number | null | void;
-  static defaultProps: DefaultProps;
-  constructor(props: Props): this;
-  componentDidMount(): void;
-  UNSAFE_componentWillReceiveProps(nextProps: Props): void;
-  componentDidUpdate(prevProps: Props, prevState: State): void;
-  componentWillUnmount(): 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: Props, callback: any): void;
-  setInputValue(path: FocusPath, newValue: any, 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;
-  getNumHints(): number;
-
-  /**
-   * Grades the item.
-   */
-  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(): {
-    [key: string]: KEScore,
-  };
-
-  /**
-   * Get a representation of the current state of the item.
-   */
-  getSerializedState(): SerializedState;
-  restoreSerializedState(state: SerializedState, callback?: () => void): void;
-  showRationalesForCurrentlySelectedChoices(): void;
-  deselectIncorrectSelectedChoices(): void;
-  setAssetStatus: (assetKey: string, status: boolean) => void;
-  render(): React.Node;
-}
-declare var ref: React.AbstractComponent<
-  $Diff<
-    {|
-      ...KeypadProps,
-      ...{|
-        apiOptions: APIOptions,
-        hintsVisible?: number | void,
-        item: {|
-          hints: $ReadOnlyArray<any>,
-          question: any,
-        |},
-        problemNum?: number | void,
-        reviewMode?: boolean | void,
-        keypadElement?: any | null | void,
-      |},
-      ...HOCProps,
-    |},
-    { onRendered: any }
-  >,
-  ServerItemRenderer
->;
-declare export default typeof ref;

package/dist/sigfigs.js.flow

@@ -1,41 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-/**
- * An object tho both scans floating points to
- * determine the number of significant figures.
- * and can display a floating point using any number
- * of significant figures.
- * @param s A string representation of a floating point.
- */
-declare export class SignificantFigures {
-  order: number;
-  mantissa: string;
-  positive: boolean;
-  sigFigs: number;
-  sigDecs: number;
-  constructor(s: string): this;
-}
-/**
- * Format a floating point for display using the specified
- * number of significant figures and least significant decimal.
- * Scientific notation may used by this method if this
- * object is very small, very large, has many significant
- * figures, or the number of significant figures would be
- * ambiguous in the output if scientific notation were not
- * used.
- * @param f A floating point number that should be displayed
- * @param sigFigs desired number of significant figures (integer).
- * @param sigDecs the least significant decimal place (integer).
- * @param scientific true iff scientific notation should always be used.
- * @return a string of this object formatted correctly.
- */
-declare export function displaySigFigs(
-  f: number,
-  sigFigs: number,
-  sigDecs: number,
-  scientific: boolean
-): string;

package/dist/styles/constants.js.flow

@@ -1,62 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-declare export var baseFontFamily: "'Proxima Nova',sans-serif";
-declare export var boldFontFamily: "'Proxima Nova Semibold',sans-serif";
-declare export var green: "#76A005";
-declare export var kaGreen: "#71B307";
-declare export var blue: "#1C758A";
-declare export var gray: "#AAAAAA";
-declare export var red: "#FFBABA";
-declare export var grayLight: "#AAAAAA";
-declare export var grayLighter: "#DDDDDD";
-declare export var learnstormBlue: "#4898FC";
-declare export var white: "#FFFFFF";
-declare export var gray98: "#FAFAFA";
-declare export var gray97: "#F6F7F7";
-declare export var gray95: "#F0F1F2";
-declare export var gray90: "#E3E5E6";
-declare export var gray85: "#D6D8DA";
-declare export var gray76: "#BABEC2";
-declare export var gray68: "#888D93";
-declare export var gray41: "#626569";
-declare export var gray25: "#3B3e40";
-declare export var gray17: "#21242c";
-declare export var black: "#000000";
-declare export var warning1: "#F86700";
-declare export var warning3: "#C75300";
-declare export var pureSmMin: "568px";
-declare export var pureMdMin: "768px";
-declare export var pureLgMin: "1024px";
-declare export var pureXlMin: "1280px";
-declare export var pureXsMax: "567px";
-declare export var pureSmMax: "767px";
-declare export var pureMdMax: "1023px";
-declare export var pureLgMax: "1279px";
-declare export var tableBackgroundAccent: "#F9F9F9";
-declare export var zIndexScratchPad: 1;
-declare export var zIndexAboveScratchpad: 2;
-declare export var zIndexInteractiveComponent: 3;
-declare export var zIndexCurrentlyDragging: 4;
-declare export var zIndexCalculator: 5;
-declare export var phoneMargin: 16;
-declare export var negativePhoneMargin: -16;
-declare export var hintBorderWidth: 4;
-declare export var baseUnitPx: 16;
-declare export var interactiveSizes: {|
-  +defaultBoxSize: 400,
-  +defaultBoxSizeSmall: 288,
-|};
-declare export var circleSize: 24;
-declare export var radioMarginWidth: 2;
-declare export var warningColor: "#f86700";
-declare export var warningColorHover: "#df5c00";
-declare export var warningColorActive: "#c75300";
-declare export var publishBlockingErrorColor: "#be2612";
-declare export var radioBorderColor: "#BABEC2";
-declare export var checkedColor: "#71B307";
-declare export var articleMaxWidthInPx: 688;
-declare export var articleMaxWidthTableInPx: 512;