@khanacademy/perseus-score 1.0.0 → 2.0.0

package/dist/util/tex-wrangler.d.ts

@@ -0,0 +1,2 @@
+export declare function modifyTex(tex: string): string;
+export declare function parseTex(tex: string): string;

package/dist/validation.types.d.ts

@@ -0,0 +1,279 @@
+/**
+ * This file contains types used for validation and scoring. The types abide by
+ * a naming convention so that they're easy to follow and that we remain
+ * consistent across all of the widgets.
+ *
+ * These types are:
+ *
+ *   * `Perseus<Widget>UserInput`: the data from the widget that represents the
+ *     data the user entered. This is referred to as the 'guess' in some older
+ *     parts of Perseus.
+ *
+ *   * `Perseus<Widget>ValidationData`: the data needed to do validation of the
+ *     user input. Validation refers to the different checks that we can do
+ *     both on the client-side (before submitting user input for scoring) and
+ *     on the server-side (when we score it). As such, it cannot contain any of
+ *     the sensitive scoring data that would reveal the answer.
+ *
+ *   * `Perseus<Widget>Rubric` (nee `Perseus<Widget>Rubric`): the data
+ *     needed to score the user input. By convention, this type is defined as
+ *     the set of sensitive answer data and then intersected with
+ *     `Perseus<Widget>ValidationData`.
+ *
+ * For example:
+ * ```
+ * type Perseus<Widget>Rubric = {
+ *     correct: string;  // Used _only_ for scoring
+ *     size: number;     // Used _only_ for scoring
+ * } & Perseus<Widget>ValidationData;
+ * ```
+ */
+import type { GrapherAnswerTypes, PerseusDropdownChoice, PerseusExpressionAnswerForm, PerseusGradedGroupSetWidgetOptions, PerseusGradedGroupWidgetOptions, PerseusGraphType, PerseusGroupWidgetOptions, PerseusMatrixWidgetAnswers, PerseusNumericInputAnswer, PerseusOrdererWidgetOptions, PerseusRadioChoice, PerseusGraphCorrectType, MakeWidgetMap, Relationship } from "@khanacademy/perseus-core";
+export type PerseusScore = {
+    type: "invalid";
+    message?: string | null | undefined;
+    suppressAlmostThere?: boolean | null | undefined;
+} | {
+    type: "points";
+    earned: number;
+    total: number;
+    message?: string | null | undefined;
+};
+export type ValidationResult = Extract<PerseusScore, {
+    type: "invalid";
+}> | null;
+export type UserInputStatus = "correct" | "incorrect" | "incomplete";
+export type PerseusCategorizerRubric = {
+    values: ReadonlyArray<number>;
+} & PerseusCategorizerValidationData;
+export type PerseusCategorizerUserInput = {
+    values: PerseusCategorizerRubric["values"];
+};
+export type PerseusCategorizerValidationData = {
+    items: ReadonlyArray<string>;
+};
+export type PerseusCSProgramUserInput = {
+    status: UserInputStatus;
+    message: string | null;
+};
+export type PerseusDropdownRubric = {
+    choices: ReadonlyArray<PerseusDropdownChoice>;
+};
+export type PerseusDropdownUserInput = {
+    value: number;
+};
+export type PerseusExpressionRubric = {
+    answerForms: ReadonlyArray<PerseusExpressionAnswerForm>;
+    functions: ReadonlyArray<string>;
+};
+export type PerseusExpressionUserInput = string;
+export type PerseusGroupRubric = PerseusGroupWidgetOptions;
+export type PerseusGroupValidationData = {
+    widgets: ValidationDataMap;
+};
+export type PerseusGroupUserInput = UserInputMap;
+export type PerseusGradedGroupRubric = PerseusGradedGroupWidgetOptions;
+export type PerseusGradedGroupSetRubric = PerseusGradedGroupSetWidgetOptions;
+export type PerseusGrapherRubric = {
+    correct: GrapherAnswerTypes;
+};
+export type PerseusGrapherUserInput = PerseusGrapherRubric["correct"];
+export type PerseusIFrameUserInput = {
+    status: UserInputStatus;
+    message: string | null;
+};
+export type PerseusInputNumberRubric = {
+    answerType?: "number" | "decimal" | "integer" | "rational" | "improper" | "mixed" | "percent" | "pi";
+    inexact?: boolean;
+    maxError?: number | string;
+    simplify: "required" | "optional" | "enforced";
+    value: string | number;
+};
+export type PerseusInputNumberUserInput = {
+    currentValue: string;
+};
+export type PerseusInteractiveGraphRubric = {
+    correct: PerseusGraphCorrectType;
+    graph: PerseusGraphType;
+};
+export type PerseusInteractiveGraphUserInput = PerseusGraphType;
+export type PerseusLabelImageRubric = {
+    markers: ReadonlyArray<{
+        answers: ReadonlyArray<string>;
+        label: string;
+    }>;
+};
+export type PerseusLabelImageUserInput = {
+    markers: ReadonlyArray<{
+        selected?: ReadonlyArray<string>;
+        label: string;
+    }>;
+};
+export type PerseusMatcherRubric = {
+    left: ReadonlyArray<string>;
+    right: ReadonlyArray<string>;
+};
+export type PerseusMatcherUserInput = {
+    left: ReadonlyArray<string>;
+    right: ReadonlyArray<string>;
+};
+export type PerseusMatrixRubric = {
+    answers: PerseusMatrixWidgetAnswers;
+} & PerseusMatrixValidationData;
+export type PerseusMatrixValidationData = Empty;
+export type PerseusMatrixUserInput = {
+    answers: PerseusMatrixRubric["answers"];
+};
+export type PerseusNumberLineRubric = {
+    correctRel: string | null | undefined;
+    correctX: number;
+    range: ReadonlyArray<number>;
+    initialX: number | null | undefined;
+    isInequality: boolean;
+};
+export type PerseusNumberLineUserInput = {
+    isTickCrtl?: boolean;
+    numLinePosition: number;
+    rel: Relationship | "eq";
+    numDivisions: number;
+    divisionRange: ReadonlyArray<number>;
+};
+export type PerseusNumericInputRubric = {
+    answers: ReadonlyArray<PerseusNumericInputAnswer>;
+    coefficient: boolean;
+};
+export type PerseusNumericInputUserInput = {
+    currentValue: string;
+};
+export type PerseusOrdererRubric = PerseusOrdererWidgetOptions;
+export type PerseusOrdererUserInput = {
+    current: ReadonlyArray<string>;
+};
+export type PerseusPlotterRubric = {
+    correct: ReadonlyArray<number>;
+} & PerseusPlotterValidationData;
+export type PerseusPlotterValidationData = {
+    starting: ReadonlyArray<number>;
+};
+export type PerseusPlotterUserInput = ReadonlyArray<number>;
+export type PerseusRadioRubric = {
+    choices: ReadonlyArray<PerseusRadioChoice>;
+};
+export type PerseusRadioUserInput = {
+    choicesSelected: ReadonlyArray<boolean>;
+};
+export type PerseusSorterRubric = {
+    correct: ReadonlyArray<string>;
+};
+export type PerseusSorterUserInput = {
+    options: ReadonlyArray<string>;
+    changed: boolean;
+};
+export type PerseusTableRubric = {
+    answers: ReadonlyArray<ReadonlyArray<string>>;
+};
+export type PerseusTableUserInput = ReadonlyArray<ReadonlyArray<string>>;
+export interface RubricRegistry {
+    categorizer: PerseusCategorizerRubric;
+    dropdown: PerseusDropdownRubric;
+    expression: PerseusExpressionRubric;
+    "graded-group-set": PerseusGradedGroupSetRubric;
+    "graded-group": PerseusGradedGroupRubric;
+    grapher: PerseusGrapherRubric;
+    group: PerseusGroupRubric;
+    image: PerseusLabelImageRubric;
+    "input-number": PerseusInputNumberRubric;
+    "interactive-graph": PerseusInteractiveGraphRubric;
+    "label-image": PerseusLabelImageRubric;
+    matcher: PerseusMatcherRubric;
+    matrix: PerseusMatrixRubric;
+    "number-line": PerseusNumberLineRubric;
+    "numeric-input": PerseusNumericInputRubric;
+    orderer: PerseusOrdererRubric;
+    plotter: PerseusPlotterRubric;
+    radio: PerseusRadioRubric;
+    sorter: PerseusSorterRubric;
+    table: PerseusTableRubric;
+}
+/**
+ * A map of scoring data (previously referred to as "rubric"), keyed by
+ * `widgetId`. This data is used to score a learner's guess for a PerseusItem.
+ *
+ * NOTE:  The value in this map is intentionally a subset of WidgetOptions<T>.
+ * By using the same shape (minus any unneeded render data), we are able to
+ * share functionality that understands how to traverse maps of `widget id` to
+ * `options`.
+ */
+export type RubricMap = {
+    [Property in keyof RubricRegistry as `${Property} ${number}`]: {
+        type: Property;
+        static?: boolean;
+        options: RubricRegistry[Property];
+    };
+};
+export type Rubric = RubricRegistry[keyof RubricRegistry];
+/**
+ * This is an interface so that it can be extended if a widget is created
+ * outside of this Perseus package. See `PerseusWidgetTypes` for a full
+ * explanation.
+ */
+interface UserInputRegistry {
+    categorizer: PerseusCategorizerUserInput;
+    "cs-program": PerseusCSProgramUserInput;
+    dropdown: PerseusDropdownUserInput;
+    expression: PerseusExpressionUserInput;
+    grapher: PerseusGrapherUserInput;
+    group: PerseusGroupUserInput;
+    iframe: PerseusIFrameUserInput;
+    "input-number": PerseusInputNumberUserInput;
+    "interactive-graph": PerseusInteractiveGraphUserInput;
+    "label-image": PerseusLabelImageUserInput;
+    matcher: PerseusMatcherUserInput;
+    matrix: PerseusMatrixUserInput;
+    "number-line": PerseusNumberLineUserInput;
+    "numeric-input": PerseusNumericInputUserInput;
+    orderer: PerseusOrdererUserInput;
+    plotter: PerseusPlotterUserInput;
+    radio: PerseusRadioUserInput;
+    sorter: PerseusSorterUserInput;
+    table: PerseusTableUserInput;
+}
+/** A union type of all the widget user input types */
+export type UserInput = UserInputRegistry[keyof UserInputRegistry];
+/**
+ * A map of widget IDs to user input types (strongly typed based on the format
+ * of the widget ID).
+ */
+export type UserInputMap = MakeWidgetMap<UserInputRegistry>;
+/**
+ * deprecated prefer using UserInputMap
+ */
+export type UserInputArray = ReadonlyArray<UserInputArray | UserInput | null | undefined>;
+export interface ValidationDataTypes {
+    categorizer: PerseusCategorizerValidationData;
+    group: PerseusGroupValidationData;
+    plotter: PerseusPlotterValidationData;
+}
+/**
+ * A map of validation data, keyed by `widgetId`. This data is used to check if
+ * a question is answerable. This data represents the minimal intersection of
+ * data that's available in the client (widget options) and server (scoring
+ * data) and is represented by a group of types known as "validation data".
+ *
+ * NOTE: The value in this map is intentionally a subset of WidgetOptions<T>.
+ * By using the same shape (minus any unneeded data), we are able to pass a
+ * `PerseusWidgetsMap` or ` into any function that accepts a
+ * `ValidationDataMap` without any mutation of data.
+ */
+export type ValidationDataMap = {
+    [Property in keyof ValidationDataTypes as `${Property} ${number}`]: {
+        type: Property;
+        static?: boolean;
+        options: ValidationDataTypes[Property];
+    };
+};
+/**
+ * A union type of all the different widget validation data types that exist.
+ */
+export type ValidationData = ValidationDataTypes[keyof ValidationDataTypes];
+export {};

package/dist/validation.typetest.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/widgets/categorizer/score-categorizer.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusCategorizerRubric, PerseusCategorizerUserInput, PerseusScore } from "../../validation.types";
+declare function scoreCategorizer(userInput: PerseusCategorizerUserInput, rubric: PerseusCategorizerRubric): PerseusScore;
+export default scoreCategorizer;

package/dist/widgets/categorizer/validate-categorizer.d.ts

@@ -0,0 +1,11 @@
+import type { ValidationResult, PerseusCategorizerUserInput, PerseusCategorizerValidationData } from "@khanacademy/perseus-score";
+/**
+ * Checks userInput from the categorizer widget to see if the user has selected
+ * a category for each item.
+ * @param userInput - The user's input corresponding to an array of indices that
+ * represent the selected category for each row/item.
+ * @param validationData - An array of strings corresponding to each row/item
+ * @param strings - Used to provide a validation message
+ */
+declare function validateCategorizer(userInput: PerseusCategorizerUserInput, validationData: PerseusCategorizerValidationData): ValidationResult;
+export default validateCategorizer;

package/dist/widgets/cs-program/score-cs-program.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusCSProgramUserInput, PerseusScore } from "../../validation.types";
+declare function scoreCSProgram(userInput: PerseusCSProgramUserInput): PerseusScore;
+export default scoreCSProgram;

package/dist/widgets/dropdown/score-dropdown.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusDropdownRubric, PerseusDropdownUserInput, PerseusScore } from "../../validation.types";
+declare function scoreDropdown(userInput: PerseusDropdownUserInput, rubric: PerseusDropdownRubric): PerseusScore;
+export default scoreDropdown;

package/dist/widgets/dropdown/validate-dropdown.d.ts

@@ -0,0 +1,7 @@
+import type { PerseusDropdownUserInput, ValidationResult } from "../../validation.types";
+/**
+ * Checks if the user has selected an item from the dropdown before scoring.
+ * This is shown with a userInput value / index other than 0.
+ */
+declare function validateDropdown(userInput: PerseusDropdownUserInput): ValidationResult;
+export default validateDropdown;

package/dist/widgets/expression/score-expression.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusExpressionRubric, PerseusExpressionUserInput, PerseusScore } from "../../validation.types";
+declare function scoreExpression(userInput: PerseusExpressionUserInput, rubric: PerseusExpressionRubric, locale: string): PerseusScore;
+export default scoreExpression;

package/dist/widgets/expression/validate-expression.d.ts

@@ -0,0 +1,11 @@
+import type { PerseusExpressionUserInput, ValidationResult } from "../../validation.types";
+/**
+ * Checks user input from the expression widget to see if it is scorable.
+ *
+ * Note: Most of the expression widget's validation requires the Rubric because
+ * of its use of KhanAnswerTypes as a core part of scoring.
+ *
+ * @see `scoreExpression()` for more details.
+ */
+declare function validateExpression(userInput: PerseusExpressionUserInput): ValidationResult;
+export default validateExpression;

package/dist/widgets/grapher/score-grapher.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusGrapherRubric, PerseusGrapherUserInput, PerseusScore } from "../../validation.types";
+declare function scoreGrapher(userInput: PerseusGrapherUserInput, rubric: PerseusGrapherRubric): PerseusScore;
+export default scoreGrapher;

package/dist/widgets/iframe/score-iframe.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusIFrameUserInput, PerseusScore } from "../../validation.types";
+declare function scoreIframe(userInput: PerseusIFrameUserInput): PerseusScore;
+export default scoreIframe;

package/dist/widgets/input-number/score-input-number.d.ts

@@ -0,0 +1,37 @@
+import type { PerseusInputNumberRubric, PerseusInputNumberUserInput, PerseusScore } from "../../validation.types";
+export declare const inputNumberAnswerTypes: {
+    readonly number: {
+        readonly name: "Numbers";
+        readonly forms: "integer, decimal, proper, improper, mixed";
+    };
+    readonly decimal: {
+        readonly name: "Decimals";
+        readonly forms: "decimal";
+    };
+    readonly integer: {
+        readonly name: "Integers";
+        readonly forms: "integer";
+    };
+    readonly rational: {
+        readonly name: "Fractions and mixed numbers";
+        readonly forms: "integer, proper, improper, mixed";
+    };
+    readonly improper: {
+        readonly name: "Improper numbers (no mixed)";
+        readonly forms: "integer, proper, improper";
+    };
+    readonly mixed: {
+        readonly name: "Mixed numbers (no improper)";
+        readonly forms: "integer, proper, mixed";
+    };
+    readonly percent: {
+        readonly name: "Numbers or percents";
+        readonly forms: "integer, decimal, proper, improper, mixed, percent";
+    };
+    readonly pi: {
+        readonly name: "Numbers with pi";
+        readonly forms: "pi";
+    };
+};
+declare function scoreInputNumber(userInput: PerseusInputNumberUserInput, rubric: PerseusInputNumberRubric): PerseusScore;
+export default scoreInputNumber;

package/dist/widgets/interactive-graph/score-interactive-graph.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusInteractiveGraphRubric, PerseusScore, PerseusInteractiveGraphUserInput } from "@khanacademy/perseus-score";
+declare function scoreInteractiveGraph(userInput: PerseusInteractiveGraphUserInput, rubric: PerseusInteractiveGraphRubric): PerseusScore;
+export default scoreInteractiveGraph;

package/dist/widgets/label-image/score-label-image.d.ts

@@ -0,0 +1,8 @@
+import type { PerseusLabelImageUserInput, PerseusLabelImageRubric, PerseusScore } from "../../validation.types";
+type InteractiveMarkerScore = {
+    hasAnswers: boolean;
+    isCorrect: boolean;
+};
+export declare function scoreLabelImageMarker(userInput: PerseusLabelImageUserInput["markers"][number]["selected"], rubric: PerseusLabelImageRubric["markers"][number]["answers"]): InteractiveMarkerScore;
+declare function scoreLabelImage(userInput: PerseusLabelImageUserInput, rubric: PerseusLabelImageRubric): PerseusScore;
+export default scoreLabelImage;

package/dist/widgets/label-image/validate-label-image.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusLabelImageUserInput, ValidationResult } from "../../validation.types";
+declare function validateLabelImage(userInput: PerseusLabelImageUserInput): ValidationResult;
+export default validateLabelImage;

package/dist/widgets/matcher/score-matcher.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusMatcherRubric, PerseusMatcherUserInput, PerseusScore } from "../../validation.types";
+declare function scoreMatcher(userInput: PerseusMatcherUserInput, rubric: PerseusMatcherRubric): PerseusScore;
+export default scoreMatcher;

package/dist/widgets/matrix/score-matrix.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusMatrixRubric, PerseusMatrixUserInput, PerseusScore } from "../../validation.types";
+declare function scoreMatrix(userInput: PerseusMatrixUserInput, rubric: PerseusMatrixRubric): PerseusScore;
+export default scoreMatrix;

package/dist/widgets/matrix/validate-matrix.d.ts

@@ -0,0 +1,11 @@
+import type { PerseusMatrixUserInput, ValidationResult } from "../../validation.types";
+/**
+ * Checks user input from the matrix widget to see if it is scorable.
+ *
+ * Note: The matrix widget cannot do much validation without the Scoring
+ * Data because of its use of KhanAnswerTypes as a core part of scoring.
+ *
+ * @see `scoreMatrix()` for more details.
+ */
+declare function validateMatrix(userInput: PerseusMatrixUserInput): ValidationResult;
+export default validateMatrix;

package/dist/widgets/number-line/score-number-line.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusNumberLineRubric, PerseusNumberLineUserInput, PerseusScore } from "../../validation.types";
+declare function scoreNumberLine(userInput: PerseusNumberLineUserInput, rubric: PerseusNumberLineRubric): PerseusScore;
+export default scoreNumberLine;

package/dist/widgets/number-line/validate-number-line.d.ts

@@ -0,0 +1,11 @@
+import type { PerseusNumberLineUserInput, PerseusScore } from "../../validation.types";
+/**
+ * Checks user input is within the allowed range and not the same as the initial
+ * state.
+ * @param userInput
+ * @see 'scoreNumberLine' for the scoring logic.
+ */
+declare function validateNumberLine(userInput: PerseusNumberLineUserInput): Extract<PerseusScore, {
+    type: "invalid";
+}> | null;
+export default validateNumberLine;

package/dist/widgets/numeric-input/score-numeric-input.d.ts

@@ -0,0 +1,4 @@
+import type { PerseusNumericInputRubric, PerseusNumericInputUserInput, PerseusScore } from "../../validation.types";
+export declare function maybeParsePercentInput(inputValue: string | number, normalizedAnswerExpected: boolean): string | number;
+declare function scoreNumericInput(userInput: PerseusNumericInputUserInput, rubric: PerseusNumericInputRubric): PerseusScore;
+export default scoreNumericInput;

package/dist/widgets/orderer/score-orderer.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusOrdererRubric, PerseusOrdererUserInput, PerseusScore } from "../../validation.types";
+declare function scoreOrderer(userInput: PerseusOrdererUserInput, rubric: PerseusOrdererRubric): PerseusScore;
+export default scoreOrderer;

package/dist/widgets/orderer/validate-orderer.d.ts

@@ -0,0 +1,9 @@
+import type { PerseusOrdererUserInput, ValidationResult } from "../../validation.types";
+/**
+ * Checks user input from the orderer widget to see if the user has started
+ * ordering the options, making the widget scorable.
+ * @param userInput
+ * @see `scoreOrderer` for more details.
+ */
+declare function validateOrderer(userInput: PerseusOrdererUserInput): ValidationResult;
+export default validateOrderer;

package/dist/widgets/plotter/score-plotter.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusPlotterUserInput, PerseusPlotterRubric, PerseusScore } from "../../validation.types";
+declare function scorePlotter(userInput: PerseusPlotterUserInput, rubric: PerseusPlotterRubric): PerseusScore;
+export default scorePlotter;

package/dist/widgets/plotter/validate-plotter.d.ts

@@ -0,0 +1,9 @@
+import type { PerseusPlotterUserInput, PerseusPlotterValidationData, ValidationResult } from "../../validation.types";
+/**
+ * Checks user input to confirm it is not the same as the starting values for the graph.
+ * This means the user has modified the graph, and the question can be scored.
+ *
+ * @see 'scorePlotter' for more details on scoring.
+ */
+declare function validatePlotter(userInput: PerseusPlotterUserInput, validationData: PerseusPlotterValidationData): ValidationResult;
+export default validatePlotter;

package/dist/widgets/radio/score-radio.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusRadioRubric, PerseusRadioUserInput, PerseusScore } from "../../validation.types";
+declare function scoreRadio(userInput: PerseusRadioUserInput, rubric: PerseusRadioRubric): PerseusScore;
+export default scoreRadio;

package/dist/widgets/radio/validate-radio.d.ts

@@ -0,0 +1,11 @@
+import type { PerseusRadioUserInput, ValidationResult } from "../../validation.types";
+/**
+ * Checks if the user has selected at least one option. Additional validation
+ * is done in scoreRadio to check if the number of selected options is correct
+ * and if the user has selected both a correct option and the "none of the above"
+ * option.
+ * @param userInput
+ * @see `scoreRadio` for the additional validation logic and the scoring logic.
+ */
+declare function validateRadio(userInput: PerseusRadioUserInput): ValidationResult;
+export default validateRadio;

package/dist/widgets/sorter/score-sorter.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusSorterRubric, PerseusSorterUserInput, PerseusScore } from "../../validation.types";
+declare function scoreSorter(userInput: PerseusSorterUserInput, rubric: PerseusSorterRubric): PerseusScore;
+export default scoreSorter;

package/dist/widgets/sorter/validate-sorter.d.ts

@@ -0,0 +1,10 @@
+import type { PerseusSorterUserInput, ValidationResult } from "../../validation.types";
+/**
+ * Checks user input for the sorter widget to ensure that the user has made
+ * changes before attempting to score the widget.
+ * @param userInput
+ * @see 'scoreSorter' in 'packages/perseus/src/widgets/sorter/score-sorter.ts'
+ * for more details on how the sorter widget is scored.
+ */
+declare function validateSorter(userInput: PerseusSorterUserInput): ValidationResult;
+export default validateSorter;

package/dist/widgets/table/score-table.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusTableRubric, PerseusScore, PerseusTableUserInput } from "../../validation.types";
+declare function scoreTable(userInput: PerseusTableUserInput, rubric: PerseusTableRubric): PerseusScore;
+export default scoreTable;

package/dist/widgets/table/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Filters the given table (modelled as a 2D array) to remove any rows that are
+ * completely empty.
+ *
+ * @returns A new table with only non-empty rows.
+ */
+export declare const filterNonEmpty: (table: ReadonlyArray<ReadonlyArray<string>>) => (readonly string[])[];

package/dist/widgets/table/validate-table.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusTableUserInput, ValidationResult } from "../../validation.types";
+declare function validateTable(userInput: PerseusTableUserInput): ValidationResult;
+export default validateTable;

package/package.json

@@ -3,7 +3,7 @@
     "description": "Perseus score",
     "author": "Khan Academy",
     "license": "MIT",
-    "version": "1.0.0",
+    "version": "2.0.0",
     "publishConfig": {
         "access": "public"
     },
@@ -26,9 +26,9 @@
         "test": "bash -c 'yarn --silent --cwd \"../..\" test ${@:0} $($([[ ${@: -1} = -* ]] || [[ ${@: -1} = bash ]]) && echo $PWD)'"
     },
     "dependencies": {
-        "@khanacademy/kas": "^0.4.10",
-        "@khanacademy/kmath": "^0.2.0",
-        "@khanacademy/perseus-core": "3.1.0"
+        "@khanacademy/kas": "^0.4.12",
+        "@khanacademy/kmath": "^0.3.1",
+        "@khanacademy/perseus-core": "3.3.0"
     },
     "devDependencies": {},
     "peerDependencies": {},