@khanacademy/perseus 7.2.1 → 8.0.0

package/dist/widgets/sorter.js.flow

@@ -1,102 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as $Flowgen$Import$_2e__2e__2f_types from "../types";
-import PropTypes from "prop-types";
-import * as React from "react";
-import type { SortableOption } from "../components/sortable";
-declare class Sorter extends React.Component<any, any> {
-  _isMounted: boolean;
-  static propTypes: {|
-    apiOptions: PropTypes.Validator<
-      $NonMaybeType<
-        PropTypes.InferProps<{|
-          isArticle: PropTypes.Validator<boolean>,
-          onInputError: PropTypes.Validator<(...args: any[]) => any>,
-          onFocusChange: PropTypes.Validator<(...args: any[]) => any>,
-          GroupMetadataEditor: PropTypes.Validator<(...args: any[]) => any>,
-          showAlignmentOptions: PropTypes.Validator<boolean>,
-          readOnly: PropTypes.Validator<boolean>,
-          answerableCallback: PropTypes.Requireable<(...args: any[]) => any>,
-          getAnotherHint: PropTypes.Requireable<(...args: any[]) => any>,
-          interactionCallback: PropTypes.Requireable<(...args: any[]) => any>,
-          groupAnnotator: PropTypes.Validator<(...args: any[]) => any>,
-          imagePlaceholder: PropTypes.Requireable<PropTypes.ReactNodeLike>,
-          widgetPlaceholder: PropTypes.Requireable<PropTypes.ReactNodeLike>,
-          baseElements: PropTypes.Requireable<
-            PropTypes.InferProps<{|
-              Link: PropTypes.Requireable<(...args: any[]) => any>,
-            |}>
-          >,
-          imagePreloader: PropTypes.Requireable<(...args: any[]) => any>,
-          trackInteraction: PropTypes.Requireable<(...args: any[]) => any>,
-          customKeypad: PropTypes.Requireable<boolean>,
-          nativeKeypadProxy: PropTypes.Requireable<(...args: any[]) => any>,
-          isMobile: PropTypes.Requireable<boolean>,
-          useV2Keypad: PropTypes.Requireable<boolean>,
-          setDrawingAreaAvailable: PropTypes.Requireable<
-            (...args: any[]) => any
-          >,
-          useDraftEditor: PropTypes.Requireable<boolean>,
-          hintProgressColor: PropTypes.Requireable<string>,
-          canScrollPage: PropTypes.Requireable<boolean>,
-          inModal: PropTypes.Requireable<boolean>,
-          crossOutEnabled: PropTypes.Requireable<boolean>,
-          editorChangeDelay: PropTypes.Requireable<number>,
-        |}>
-      >
-    >,
-    correct: PropTypes.Requireable<any[]>,
-    layout: PropTypes.Requireable<string>,
-    onChange: PropTypes.Requireable<(...args: any[]) => any>,
-    padding: PropTypes.Requireable<boolean>,
-    problemNum: PropTypes.Requireable<number>,
-    trackInteraction: PropTypes.Validator<(...args: any[]) => any>,
-    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)[]>,
-      |}>
-    >,
-  |};
-  static defaultProps: any;
-  static validate(state: any, rubric: any): any;
-  state: any;
-  componentDidMount(): void;
-  componentWillUnmount(): void;
-  handleChange: (arg1: SyntheticInputEvent<HTMLInputElement>) => void;
-  getUserInput: () => {|
-    options: any,
-  |};
-  moveOptionToIndex: (option: SortableOption, index: number) => void;
-  simpleValidate: (arg1: any) => any;
-  render(): React.Node;
-}
-declare var _default: $ReadOnly<{|
-  name: string,
-  displayName: string,
-  getWidget?: (() => typeof Sorter) | void,
-  accessible?: boolean | ((props: any) => boolean) | void,
-  hidden?: boolean | void,
-  version?: $Flowgen$Import$_2e__2e__2f_types.Version | void,
-  supportedAlignments?: $ReadOnlyArray<$Flowgen$Import$_2e__2e__2f_types.Alignment> | void,
-  defaultAlignment?: $Flowgen$Import$_2e__2e__2f_types.Alignment | void,
-  getDefaultAlignment?:
-    | (() => $Flowgen$Import$_2e__2e__2f_types.Alignment)
-    | void,
-  isLintable?: boolean | void,
-  tracking?: $Flowgen$Import$_2e__2e__2f_types.Tracking | void,
-  traverseChildWidgets?: any,
-  transform?: $Flowgen$Import$_2e__2e__2f_types.WidgetTransform | void,
-  staticTransform?: $Flowgen$Import$_2e__2e__2f_types.WidgetTransform | void,
-  propUpgrades?: {
-    [key: string]: (arg1: any) => any,
-  } | void,
-  widget: typeof Sorter,
-|}>;
-declare export default typeof _default;

package/dist/widgets/table.js.flow

@@ -1,67 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as $Flowgen$Import$_2e__2e__2f_types from "../types";
-import PropTypes from "prop-types";
-import * as React from "react";
-declare class Table extends React.Component<any> {
-  static propTypes: {|
-    answers: PropTypes.Requireable<((string | null | void)[] | null | void)[]>,
-    editableHeaders: PropTypes.Requireable<boolean>,
-    Editor: PropTypes.Requireable<(...args: any[]) => any>,
-    headers: PropTypes.Requireable<(string | null | void)[]>,
-    keypadElement: any,
-    trackInteraction: PropTypes.Validator<(...args: any[]) => any>,
-    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)[]>,
-      |}>
-    >,
-  |};
-  static defaultProps: any;
-  _getRows: () => number;
-  _getColumns: () => number;
-  render(): React.Node;
-  getUserInput: () => any;
-  onValueChange: (arg1: any, arg2: any, arg3: any) => void;
-  onHeaderChange: (arg1: number, arg2: any) => void;
-  simpleValidate: (arg1: any) => any;
-  _handleFocus: (arg1: any) => void;
-  _handleBlur: (arg1: any) => void;
-  focus: () => boolean;
-  focusInputPath: (arg1: any) => void;
-  blurInputPath: (arg1: any) => void;
-  getDOMNodeForPath: (arg1: any) => Text | Element | null | void;
-  getInputPaths: () => $ReadOnlyArray<$ReadOnlyArray<string>>;
-  getGrammarTypeForPath: (arg1: any) => string;
-  setInputValue: (arg1: any, arg2: any, arg3: any) => void;
-}
-declare var _default: $ReadOnly<{|
-  name: string,
-  displayName: string,
-  getWidget?: (() => typeof Table) | void,
-  accessible?: boolean | ((props: any) => boolean) | void,
-  hidden?: boolean | void,
-  version?: $Flowgen$Import$_2e__2e__2f_types.Version | void,
-  supportedAlignments?: $ReadOnlyArray<$Flowgen$Import$_2e__2e__2f_types.Alignment> | void,
-  defaultAlignment?: $Flowgen$Import$_2e__2e__2f_types.Alignment | void,
-  getDefaultAlignment?:
-    | (() => $Flowgen$Import$_2e__2e__2f_types.Alignment)
-    | void,
-  isLintable?: boolean | void,
-  tracking?: $Flowgen$Import$_2e__2e__2f_types.Tracking | void,
-  traverseChildWidgets?: any,
-  transform?: $Flowgen$Import$_2e__2e__2f_types.WidgetTransform | void,
-  staticTransform?: $Flowgen$Import$_2e__2e__2f_types.WidgetTransform | void,
-  propUpgrades?: {
-    [key: string]: (arg1: any) => any,
-  } | void,
-  widget: typeof Table,
-|}>;
-declare export default typeof _default;

package/dist/widgets/transformer.js.flow

@@ -1,127 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as $Flowgen$Import$_2e__2e__2f_types from "../types";
-import * as React from "react";
-import type { Coord } from "../interactive2/types";
-import type {
-  PerseusTransformerWidgetOptions,
-  PerseusTransformerTransformation as TransformerTransformation,
-} from "../perseus-types";
-import type { Path, PerseusScore, WidgetProps } from "../types";
-declare type Graphie = any;
-declare type Tool = any;
-declare type ToolCleanup = any;
-declare type Rubric = PerseusTransformerWidgetOptions;
-declare type RenderProps = PerseusTransformerWidgetOptions;
-declare type UserInput = any;
-declare type Props = {|
-  ...WidgetProps<RenderProps, Rubric>,
-  ...{|
-    transformations: $ReadOnlyArray<TransformerTransformation>,
-    keypadElement: any,
-  |},
-|};
-declare class Transformer extends React.Component<Props> {
-  tools: {
-    [key: string]: Tool,
-  };
-  currentTool: Tool | null | void;
-  transformations: $ReadOnlyArray<TransformerTransformation>;
-  shape: any | null | void;
-  dilationCircle: any | null | void;
-  rotatePoint: any | null | void;
-  rotateHandle: any | null | void;
-  static defaultProps: any;
-  render(): React.Node;
-  componentDidMount(): void;
-  componentDidUpdate(prevProps: Props): void;
-  shouldSetupGraphie: (arg1: Props, arg2: Props) => boolean;
-  graphie: () => Graphie;
-  setupGraphie: (arg1: Graphie) => void;
-  setTransformations: (arg1: $ReadOnlyArray<TransformerTransformation>) => void;
-  addTransformerShape: (arg1: any, arg2: boolean) => void;
-  addTool: (arg1: $PropertyType<TransformerTransformation, "type">) => void;
-  removeTool: (arg1: string) => void;
-  addTranslationTool: () => any;
-  snapCoord: (arg1: Coord) => Coord;
-  normalizeReflectionCoords: (arg1: [Coord, Coord]) => [Coord, Coord];
-  addReflectionTool: () => ToolCleanup;
-  scaleToCurrentRange: (arg1: number) => number;
-  addRotationTool: () => ToolCleanup;
-  addDilationTool: () => ToolCleanup;
-  getRotationTransformFromAngle: (
-    arg1: Coord,
-    arg2: number
-  ) => TransformerTransformation;
-  doTransform: (
-    arg1: TransformerTransformation,
-    arg2?: (arg1: any) => mixed | null | void
-  ) => void;
-  applyTransform: (arg1: TransformerTransformation) => void;
-  applyCoordTransformation: (arg1: TransformerTransformation) => void;
-  resetCoords: () => void;
-  handleUndoClick: () => void;
-  setTransformationProps: (
-    arg1: $ReadOnlyArray<TransformerTransformation>,
-    arg2: (arg1: any) => mixed
-  ) => void;
-  addTransform: (
-    arg1: TransformerTransformation,
-    arg2?: (arg1: any) => mixed | null | void
-  ) => void;
-  changeTool: (arg1: Tool, arg2: any) => void;
-  simpleValidate: (arg1: Rubric) => PerseusScore;
-
-  /**
-   * Calculate where the coordinates would be if they were
-   * moved, even if we're in formal mode with no movement
-   * (and thus the actual movablepoints may not have moved
-   */
-  getCoords: () => Coord;
-  getEditorJSON: () => any;
-  getUserInput: UserInput;
-  _handleFocus: (...rest: $ReadOnlyArray<string>) => void;
-  _handleBlur: (...rest: $ReadOnlyArray<string>) => void;
-  _getTransformationForID: (arg1: string) => any;
-  getInputPaths: () => $ReadOnlyArray<Path>;
-  _passToInner: (
-    arg1: string,
-    arg2: $ReadOnlyArray<string>,
-    arg3?: any | null | void,
-    arg4?: (arg1: any) => mixed | null | void
-  ) => any;
-  focus: () => boolean;
-  focusInputPath: (arg1: Path) => boolean;
-  blurInputPath: (arg1: Path) => boolean;
-  setInputValue: (arg1: Path, arg2: any, arg3: (arg1: any) => mixed) => any;
-  getDOMNodeForPath: (arg1: Path) => any;
-  getGrammarTypeForPath: (arg1: Path) => any;
-  static validate(guess: UserInput, rubric: Rubric): PerseusScore;
-}
-declare var _default: $ReadOnly<{|
-  name: string,
-  displayName: string,
-  getWidget?: (() => typeof Transformer) | void,
-  accessible?: boolean | ((props: any) => boolean) | void,
-  hidden?: boolean | void,
-  version?: $Flowgen$Import$_2e__2e__2f_types.Version | void,
-  supportedAlignments?: $ReadOnlyArray<$Flowgen$Import$_2e__2e__2f_types.Alignment> | void,
-  defaultAlignment?: $Flowgen$Import$_2e__2e__2f_types.Alignment | void,
-  getDefaultAlignment?:
-    | (() => $Flowgen$Import$_2e__2e__2f_types.Alignment)
-    | void,
-  isLintable?: boolean | void,
-  tracking?: $Flowgen$Import$_2e__2e__2f_types.Tracking | void,
-  traverseChildWidgets?: any,
-  transform?: $Flowgen$Import$_2e__2e__2f_types.WidgetTransform | void,
-  staticTransform?: $Flowgen$Import$_2e__2e__2f_types.WidgetTransform | void,
-  propUpgrades?: {
-    [key: string]: (arg1: any) => any,
-  } | void,
-  widget: typeof Transformer,
-|}>;
-declare export default typeof _default;

package/dist/widgets/unit.js.flow

@@ -1,93 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as $Flowgen$Import$_2e__2e__2f_types from "../types";
-import * as React from "react";
-import type { APIOptions, ChangeHandler, FocusPath } from "../types";
-declare export var countSigfigs: (value: string) => number;
-declare export var sigfigPrint: (num: number, sigfigs: number) => string;
-declare type Rubric =
-  | {|
-      value: string,
-      sigfigs: number,
-      accepting: "all",
-    |}
-  | {|
-      value: string,
-      sigfigs: number,
-      accepting: "some",
-      acceptingUnits: $ReadOnlyArray<string>,
-    |};
-declare type ValidationResult =
-  | {|
-      type: "points",
-      earned: 1 | 0,
-      message: string | null | void,
-      total: number,
-    |}
-  | {|
-      type: "invalid",
-      message: string | null | void,
-    |};
-declare type Props = {|
-  apiOptions: APIOptions,
-  onChange: ChangeHandler,
-  value: string,
-  onBlur: (arg1: FocusPath) => mixed,
-  onFocus: (arg1: FocusPath) => mixed,
-|};
-declare type DefaultProps = {|
-  apiOptions: $PropertyType<Props, "apiOptions">,
-  value: $PropertyType<Props, "value">,
-|};
-declare export class OldUnitInput extends React.Component<Props> {
-  _errorTimeout: number | null | void;
-  static defaultProps: DefaultProps;
-  static validate(userInput: string, rubric: Rubric): ValidationResult;
-  componentDidUpdate(): void;
-  componentWillUnmount(): void;
-  _showError: () => void;
-  _hideError: () => void;
-  change: (...args: $ReadOnlyArray<any>) => any | null | void;
-  handleBlur: () => void;
-  handleChange: (event: SyntheticInputEvent<HTMLInputElement>) => void;
-  simpleValidate: (
-    rubric: Rubric,
-    onInputError?: () => mixed
-  ) => ValidationResult;
-  getUserInput: () => string;
-  getInputPaths: () => $ReadOnlyArray<$ReadOnlyArray<any>>;
-  focusInputPath: (inputPath: FocusPath) => void;
-  handleFocus: () => void;
-  blurInputPath: (inputPath: FocusPath) => void;
-  setInputValue: (path: FocusPath, newValue: string, cb: () => mixed) => void;
-  getDOMNodeForPath: () => null | Element | Text;
-  getGrammarTypeForPath: (inputPath: FocusPath) => string;
-  render(): React.Node;
-}
-declare var _default: $ReadOnly<{|
-  name: string,
-  displayName: string,
-  getWidget?: (() => typeof OldUnitInput) | void,
-  accessible?: boolean | ((props: any) => boolean) | void,
-  hidden?: boolean | void,
-  version?: $Flowgen$Import$_2e__2e__2f_types.Version | void,
-  supportedAlignments?: $ReadOnlyArray<$Flowgen$Import$_2e__2e__2f_types.Alignment> | void,
-  defaultAlignment?: $Flowgen$Import$_2e__2e__2f_types.Alignment | void,
-  getDefaultAlignment?:
-    | (() => $Flowgen$Import$_2e__2e__2f_types.Alignment)
-    | void,
-  isLintable?: boolean | void,
-  tracking?: $Flowgen$Import$_2e__2e__2f_types.Tracking | void,
-  traverseChildWidgets?: any,
-  transform?: $Flowgen$Import$_2e__2e__2f_types.WidgetTransform | void,
-  staticTransform?: $Flowgen$Import$_2e__2e__2f_types.WidgetTransform | void,
-  propUpgrades?: {
-    [key: string]: (arg1: any) => any,
-  } | void,
-  widget: typeof OldUnitInput,
-|}>;
-declare export default typeof _default;

package/dist/widgets/video-transcript-link.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 Props = {|
-  location: string,
-|};
-/**
- * Video Transcript Link Component.
- */
-declare var VideoTranscriptLink: (props: Props) => React.Element<any>;
-declare export default typeof VideoTranscriptLink;

package/dist/widgets/video.js.flow

@@ -1,57 +0,0 @@
-/**
- * Flowtype definitions for data
- * Generated by Flowgen from a Typescript Definition
- * Flowgen v1.21.0
- * @flow
- */
-import * as $Flowgen$Import$_2e__2e__2f_types from "../types";
-import * as React from "react";
-import type { PerseusVideoWidgetOptions } from "../perseus-types";
-import type { PerseusScore, WidgetProps } from "../types";
-declare type UserInput = null;
-declare type Rubric = PerseusVideoWidgetOptions;
-declare type RenderProps = PerseusVideoWidgetOptions;
-declare type Props = {|
-  ...WidgetProps<RenderProps, Rubric>,
-  ...{|
-    alignment: string,
-  |},
-|};
-/**
- * Video renderer.
- */
-declare class Video extends React.Component<Props> {
-  /**
-   * This is the widget's grading function.
-   * Points for videos are tallied by the embedded video itself, in the case
-   * of Khan Academy videos.
-   */
-  static validate(userInput: UserInput, rubric: Rubric): PerseusScore;
-  getUserInput: () => void | null | void;
-  simpleValidate: (arg1: Rubric) => PerseusScore;
-  change: (...args: $ReadOnlyArray<mixed>) => any;
-  render(): React.Node;
-}
-declare var _default: $ReadOnly<{|
-  name: string,
-  displayName: string,
-  getWidget?: (() => typeof Video) | void,
-  accessible?: boolean | ((props: any) => boolean) | void,
-  hidden?: boolean | void,
-  version?: $Flowgen$Import$_2e__2e__2f_types.Version | void,
-  supportedAlignments?: $ReadOnlyArray<$Flowgen$Import$_2e__2e__2f_types.Alignment> | void,
-  defaultAlignment?: $Flowgen$Import$_2e__2e__2f_types.Alignment | void,
-  getDefaultAlignment?:
-    | (() => $Flowgen$Import$_2e__2e__2f_types.Alignment)
-    | void,
-  isLintable?: boolean | void,
-  tracking?: $Flowgen$Import$_2e__2e__2f_types.Tracking | void,
-  traverseChildWidgets?: any,
-  transform?: $Flowgen$Import$_2e__2e__2f_types.WidgetTransform | void,
-  staticTransform?: $Flowgen$Import$_2e__2e__2f_types.WidgetTransform | void,
-  propUpgrades?: {
-    [key: string]: (arg1: any) => any,
-  } | void,
-  widget: typeof Video,
-|}>;
-declare export default typeof _default;

package/dist/widgets.js.flow

@@ -1,108 +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 {
-  Alignment,
-  Tracking,
-  Version,
-  WidgetExports,
-  WidgetInfo,
-  WidgetTransform,
-} from "./types";
-declare type Editor = any;
-declare export var registerWidget: (
-  name: string,
-  widget: WidgetExports
-) => void;
-declare export var registerWidgets: (
-  widgets: $ReadOnlyArray<WidgetExports>
-) => void;
-declare export var registerEditors: (
-  editorsToRegister: $ReadOnlyArray<Editor>
-) => void;
-declare export var getWidget: (
-  name: string
-) => React.ComponentType<any> | null | void;
-declare export var getEditor: (name: string) => Editor | null | void;
-declare export var getTransform: (
-  name: string
-) => WidgetTransform | null | void;
-declare export var getVersion: (name: string) => Version | null | void;
-declare export var getVersionVector: () => {
-  [key: string]: Version,
-};
-declare export var getPublicWidgets: () => $ReadOnlyArray<WidgetExports>;
-declare export var isAccessible: (widgetInfo: WidgetInfo) => boolean;
-declare export var getAllWidgetTypes: () => $ReadOnlyArray<string>;
-declare export var upgradeWidgetInfoToLatestVersion: (
-  oldWidgetInfo: WidgetInfo
-) => WidgetInfo;
-declare export var getRendererPropsForWidgetInfo: (
-  widgetInfo: WidgetInfo,
-  problemNum?: number
-) => any;
-declare export var traverseChildWidgets: (
-  widgetInfo: WidgetInfo,
-  traverseRenderer: any
-) => WidgetInfo;
-/**
- * Handling for the optional alignments for widgets
- * See widget-container.jsx for details on how alignments are implemented.
- */
-/**
- * Returns the list of supported alignments for the given (string) widget
- * type. This is used primarily at editing time to display the choices
- * for the user.
- *
- * Supported alignments are given as an array of strings in the exports of
- * a widget's module.
- */
-declare export var getSupportedAlignments: (
-  type: string
-) => $ReadOnlyArray<Alignment>;
-/**
- * For the given (string) widget type, determine the default alignment for
- * the widget. This is used at rendering time to go from "default" alignment
- * to the actual alignment displayed on the screen.
- *
- * The default alignment is given either as a string (called
- * `defaultAlignment`) or a function (called `getDefaultAlignment`) on
- * the exports of a widget's module.
- */
-declare export var getDefaultAlignment: (type: string) => Alignment;
-/**
- * Used at startup to fail fast if an alignment given by a widget is
- * invalid.
- */
-declare export var validateAlignments: () => void;
-/**
- * Handling for static mode for widgets that support it.
- */
-/**
- * Returns true iff the widget supports static mode.
- * A widget implicitly supports static mode if it exports a
- * staticTransform function.
- */
-declare export var supportsStaticMode: (type: string) => boolean;
-/**
- * Return the staticTransform function used to convert the editorProps to
- * the rendered widget state.
- */
-declare export var getStaticTransform: (
-  type: string
-) => WidgetTransform | null | void;
-/**
- * Returns the tracking option for the widget. The default is "",
- * which means simply to track interactions once. The other available
- * option is "all" which means to track all interactions.
- */
-declare export var getTracking: (type: string) => Tracking;
-/**
- * Returns true if this widget can include lintable markdown text
- * and supports a highlightLint prop, or false otherwise.
- */
-declare export var isLintable: (type: string) => boolean;

package/dist/zoom.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 ZoomService: any;

package/src/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, ...};