@khanacademy/perseus 47.0.0 → 48.0.0

package/dist/perseus-types.d.ts

@@ -1,8 +1,37 @@
-import type { Coord } from "./interactive2/types";
-import type { Interval, vec } from "mafs";
+/**
+ * The Perseus "data schema" file.
+ *
+ * This file, and the types in it, represents the "data schema" that Perseus
+ * uses. The @khanacademy/perseus-editor package edits and produces objects
+ * that conform to the types in this file. Similarly, the top-level renderers
+ * in @khanacademy/perseus, consume objects that conform to these types.
+ *
+ * WARNING: This file should not import any types from elsewhere so that it is
+ * easy to reason about changes that alter the Perseus schema. This helps
+ * ensure that it is not changed accidentally when upgrading a dependant
+ * package or other part of Perseus code. Note that TypeScript does type
+ * checking via something called "structural typing". This means that as long
+ * as the shape of a type matches, the name it goes by doesn't matter. As a
+ * result, a `Coord` type that looks like this `[x: number, y: number]` is
+ * _identical_, in TypeScript's eyes, to this `Vector2` type `[x: number, y:
+ * number]`. Also, with tuples, the labels for each entry is ignored, so `[x:
+ * number, y: number]` is compatible with `[min: number, max: number]`. The
+ * labels are for humans, not TypeScript. :)
+ *
+ * If you make changes to types in this file, be very sure that:
+ *
+ *   a) the changes are backwards compatible. If they are not, old data from
+ *      previous versions of the "schema" could become unrenderable, or worse,
+ *      introduce hard-to-diagnose bugs.
+ *   b) the parsing code (`util/parse-perseus-json/`) is updated to handle
+ *      the new format _as well as_ the old format.
+ */
+export type Coord = [x: number, y: number];
+export type Interval = [min: number, max: number];
+export type Vector2 = Coord;
 export type Range = Interval;
-export type Size = [number, number];
-export type CollinearTuple = [vec.Vector2, vec.Vector2];
+export type Size = [width: number, height: number];
+export type CollinearTuple = [Vector2, Vector2];
 export type ShowSolutions = "all" | "selected" | "none";
 /**
  * Our core set of Perseus widgets.

package/dist/renderer.d.ts

@@ -228,10 +228,6 @@ declare class Renderer extends React.Component<Props, State> implements GetPromp
      * @deprecated use scorePerseusItem
      */
     score(): PerseusScore;
-    /**
-     * @deprecated use scorePerseusItem
-     */
-    guessAndScore: () => [UserInputArray, PerseusScore];
     handletranslationLintErrors: (lintErrors: ReadonlyArray<string>) => void;
     render(): React.ReactNode;
 }

package/dist/server-item-renderer.d.ts

@@ -105,12 +105,6 @@ export declare class ServerItemRenderer extends React.Component<Props, State> im
      * Returns an object of the widget `.getUserInput()` results
      */
     getUserInput(): UserInputMap;
-    /**
-     * Grades the item.
-     *
-     * @deprecated use scorePerseusItem
-     */
-    scoreInput(): KEScore;
     /**
      * Returns an array of all widget IDs in the order they occur in
      * the question content.

package/dist/util/test-utils.d.ts

@@ -1,5 +1,11 @@
-import type { CategorizerWidget, ExpressionWidget, InteractiveGraphWidget, NumericInputWidget, PerseusItem, RadioWidget } from "../perseus-types";
+import type { CategorizerWidget, ExpressionWidget, InteractiveGraphWidget, NumericInputWidget, PerseusItem, PerseusRenderer, RadioWidget } from "../perseus-types";
+import type { PerseusScore } from "../types";
+import type { UserInputMap } from "../validation.types";
 export declare const genericPerseusItemData: PerseusItem;
+/**
+ * Thin wrapper around scorePerseusItem for internal testing
+ */
+export declare function scorePerseusItemTesting(perseusRenderData: PerseusRenderer, userInputMap: UserInputMap): PerseusScore;
 /**
  * Generate a Perseus item object for testing purposes.
  *

package/package.json

@@ -3,7 +3,7 @@
     "description": "Core Perseus API (includes renderers and widgets)",
     "author": "Khan Academy",
     "license": "MIT",
-    "version": "47.0.0",
+    "version": "48.0.0",
     "publishConfig": {
         "access": "public"
     },
@@ -40,14 +40,14 @@
         "test": "bash -c 'yarn --silent --cwd \"../..\" test ${@:0} $($([[ ${@: -1} = -* ]] || [[ ${@: -1} = bash ]]) && echo $PWD)'"
     },
     "dependencies": {
-        "@khanacademy/kas": "^0.4.2",
-        "@khanacademy/keypad-context": "^1.0.4",
-        "@khanacademy/kmath": "^0.1.16",
-        "@khanacademy/math-input": "^21.1.6",
-        "@khanacademy/perseus-core": "1.5.3",
-        "@khanacademy/perseus-linter": "^1.2.4",
-        "@khanacademy/pure-markdown": "^0.3.13",
-        "@khanacademy/simple-markdown": "^0.13.6",
+        "@khanacademy/kas": "^0.4.3",
+        "@khanacademy/keypad-context": "^1.0.5",
+        "@khanacademy/kmath": "^0.1.17",
+        "@khanacademy/math-input": "^21.1.7",
+        "@khanacademy/perseus-core": "2.0.0",
+        "@khanacademy/perseus-linter": "^1.2.5",
+        "@khanacademy/pure-markdown": "^0.3.14",
+        "@khanacademy/simple-markdown": "^0.13.7",
         "@types/classnames": "2.2.0",
         "@use-gesture/react": "^10.2.27",
         "mafs": "0.19.0",