@khanacademy/perseus-core 0.0.0-PR862-20231207182125 → 0.0.0-PR875-20250221232857

package/dist/utils/equality.d.ts

@@ -0,0 +1,9 @@
+/**
+ * APPROXIMATE equality on numbers and primitives.
+ */
+export declare function approximateEqual<T>(x: T, y: T): boolean;
+/**
+ * Deep APPROXIMATE equality on primitives, numbers, arrays, and objects.
+ * Recursive.
+ */
+export declare function approximateDeepEqual<T>(x: T, y: T): boolean;

package/dist/utils/get-decimal-separator.d.ts

@@ -0,0 +1,5 @@
+/**
+ *  Get the character used for separating decimals.
+ */
+declare const getDecimalSeparator: (locale: string) => string;
+export default getDecimalSeparator;

package/dist/utils/get-matrix-size.d.ts

@@ -0,0 +1,2 @@
+declare function getMatrixSize(matrix: ReadonlyArray<ReadonlyArray<number>>): number[];
+export default getMatrixSize;

package/dist/utils/grapher-types.d.ts

@@ -0,0 +1,58 @@
+import type { Coord } from "../data-schema";
+export type Coords = [Coord, Coord];
+type SharedGrapherType = {
+    url: string;
+    defaultCoords: Coords;
+    getFunctionForCoeffs: (coeffs: ReadonlyArray<number>, x: number) => number;
+    getEquationString: (coords: Coords, asymptote?: Coords) => string | null;
+    areEqual: (coeffs1: ReadonlyArray<number>, coeffs2: ReadonlyArray<number>) => boolean;
+    Movable: any;
+    getCoefficients: (coords: Coords, asymptote?: Coords) => ReadonlyArray<number> | undefined;
+};
+type AsymptoticGraphsType = {
+    defaultAsymptote: Coords;
+    extraCoordConstraint: (newCoord: Coord, oldCoord: Coord, coords: Coords, asymptote: Coords, graph: any) => boolean | Coord;
+    extraAsymptoteConstraint: (newCoord: Coord, oldCoord: Coord, coords: Coords, asymptote: Coords, graph: any) => Coord;
+    allowReflectOverAsymptote: boolean;
+};
+export type LinearType = SharedGrapherType & {
+    getPropsForCoeffs: (coeffs: ReadonlyArray<number>) => {
+        fn: any;
+    };
+};
+export type QuadraticType = SharedGrapherType & {
+    getPropsForCoeffs: (coeffs: ReadonlyArray<number>) => {
+        a: number;
+        b: number;
+        c: number;
+    };
+};
+export type SinusoidType = SharedGrapherType & {
+    getPropsForCoeffs: (coeffs: ReadonlyArray<number>) => {
+        a: number;
+        b: number;
+        c: number;
+        d: number;
+    };
+};
+export type TangentType = SharedGrapherType & {
+    getPropsForCoeffs: (coeffs: ReadonlyArray<number>) => {
+        fn: any;
+    };
+};
+export type ExponentialType = SharedGrapherType & AsymptoticGraphsType & {
+    getPropsForCoeffs: (coeffs: ReadonlyArray<number>) => {
+        fn: any;
+    };
+};
+export type LogarithmType = SharedGrapherType & AsymptoticGraphsType & {
+    getPropsForCoeffs: (coeffs: ReadonlyArray<number>) => {
+        fn: any;
+    };
+};
+export type AbsoluteValueType = SharedGrapherType & {
+    getPropsForCoeffs: (coeffs: ReadonlyArray<number>) => {
+        fn: any;
+    };
+};
+export {};

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

@@ -0,0 +1,20 @@
+import type { LinearType, QuadraticType, SinusoidType, TangentType, ExponentialType, LogarithmType, AbsoluteValueType } from "./grapher-types";
+export declare const MOVABLES: {
+    PLOT: string;
+    PARABOLA: string;
+    SINUSOID: string;
+};
+declare const functionTypeMapping: {
+    readonly linear: LinearType;
+    readonly quadratic: QuadraticType;
+    readonly sinusoid: SinusoidType;
+    readonly tangent: TangentType;
+    readonly exponential: ExponentialType;
+    readonly logarithm: LogarithmType;
+    readonly absolute_value: AbsoluteValueType;
+};
+export declare const allTypes: any;
+export type FunctionTypeMappingKeys = keyof typeof functionTypeMapping;
+type ConditionalGraderType<T extends FunctionTypeMappingKeys> = T extends "linear" ? LinearType : T extends "quadratic" ? QuadraticType : T extends "sinusoid" ? SinusoidType : T extends "tangent" ? TangentType : T extends "exponential" ? ExponentialType : T extends "logarithm" ? LogarithmType : T extends "absolute_value" ? AbsoluteValueType : never;
+export declare function functionForType<T extends FunctionTypeMappingKeys>(type: T): ConditionalGraderType<T>;
+export {};

package/dist/utils/is-real-json-parse.d.ts

@@ -0,0 +1 @@
+export declare function isRealJSONParse(jsonParse: typeof JSON.parse): boolean;

package/dist/utils/objective_.d.ts

@@ -0,0 +1,30 @@
+/**
+ * _ utilities for objects
+ */
+/**
+ * Does a pluck on keys inside objects in an object
+ *
+ * Ex:
+ * tools = {
+ *     translation: {
+ *         enabled: true
+ *     },
+ *     rotation: {
+ *         enabled: false
+ *     }
+ * };
+ * pluckObject(tools, "enabled") returns {
+ *     translation: true
+ *     rotation: false
+ * }
+ */
+export declare const pluck: (table: any, subKey: string) => any;
+/**
+ * Maps an object to an object
+ *
+ * > mapObject({a: '1', b: '2'}, (value, key) => {
+ *       return value + 1;
+ *   });
+ * {a: 2, b: 3}
+ */
+export declare const mapObject: <K extends string, V, U>(obj: Record<K, V>, lambda: (arg1: V, arg2: K) => U) => Record<K, U>;

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

@@ -0,0 +1,5 @@
+type RNG = () => number;
+export declare const seededRNG: (seed: number) => RNG;
+export declare function shuffle<T>(array: ReadonlyArray<T>, randomSeed: number | RNG, ensurePermuted?: boolean): ReadonlyArray<T>;
+export declare const random: RNG;
+export {};

package/dist/utils/split-perseus-item.d.ts

@@ -0,0 +1,2 @@
+import type { PerseusRenderer } from "../data-schema";
+export default function splitPerseusItem(originalItem: PerseusRenderer): PerseusRenderer;

package/dist/utils/widget-id-utils.d.ts

@@ -0,0 +1,38 @@
+import type { PerseusWidgetsMap } from "../data-schema";
+/**
+ * Add a widget placeholder using the widget ID.
+ * ex. addWidget("radio 1") => "[[☃ radio 1]]"
+ *
+ * @param {string} id
+ * @returns {string}
+ */
+export declare function addWidget(id: string): string;
+/**
+ * Regex for widget placeholders in a string.
+ *
+ * First capture group is the widget ID (ex. 'radio 1')
+ * Second capture group is the widget type (ex. "radio)
+ * exec return will look like: ['[[☃ radio 1]]', 'radio 1', 'radio']
+ */
+export declare function getWidgetRegex(): RegExp;
+/**
+ * Extract all widget IDs, which includes the widget type and instance number.
+ * example output: ['radio 1', 'categorizer 1', 'categorizor 2']
+ *
+ * Content should contain Perseus widget placeholders,
+ * which look like: '[[☃ radio 1]]'.
+ *
+ * @param {string} content
+ * @returns {ReadonlyArray<string>} widgetIds
+ */
+export declare function getWidgetIdsFromContent(content: string): ReadonlyArray<string>;
+/**
+ * Get a list of widget IDs from content,
+ * but only for specific widget types
+ *
+ * @param {string} type the type of widget (ie "radio")
+ * @param {string} content the string to parse
+ * @param {PerseusWidgetsMap} widgetMap widget ID to widget map
+ * @returns {ReadonlyArray<string>} the widget type (ie "radio")
+ */
+export declare function getWidgetIdsFromContentByType(type: string, content: string, widgetMap: PerseusWidgetsMap): ReadonlyArray<string>;

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

@@ -0,0 +1,17 @@
+import type { PerseusCategorizerWidgetOptions } from "@khanacademy/perseus-core";
+/**
+ * For details on the individual options, see the
+ * PerseusCategorizerWidgetOptions type
+ */
+type CategorizerPublicWidgetOptions = {
+    items: PerseusCategorizerWidgetOptions["items"];
+    categories: PerseusCategorizerWidgetOptions["categories"];
+    randomizeItems: PerseusCategorizerWidgetOptions["randomizeItems"];
+    static: PerseusCategorizerWidgetOptions["static"];
+};
+/**
+ * Given a PerseusCategorizerWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+declare function getCategorizerPublicWidgetOptions(options: PerseusCategorizerWidgetOptions): CategorizerPublicWidgetOptions;
+export default getCategorizerPublicWidgetOptions;

package/dist/widgets/categorizer/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusCategorizerWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type CategorizerDefaultWidgetOptions = Pick<PerseusCategorizerWidgetOptions, "items" | "categories" | "values" | "randomizeItems">;
+declare const categorizerWidgetLogic: WidgetLogic;
+export default categorizerWidgetLogic;

package/dist/widgets/core-widget-registry.d.ts

@@ -0,0 +1,30 @@
+import type { PublicWidgetOptionsFunction } from "./logic-export.types";
+import type { Alignment } from "../types";
+export declare function isWidgetRegistered(type: string): boolean;
+export declare function getCurrentVersion(type: string): any;
+export declare const getPublicWidgetOptionsFunction: (name: string) => PublicWidgetOptionsFunction;
+export declare function getWidgetOptionsUpgrades(type: string): any;
+export declare function getDefaultWidgetOptions(type: string): any;
+/**
+ * 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.
+ */
+export declare const 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.
+ */
+export declare const getDefaultAlignment: (type: string) => Alignment;

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

@@ -0,0 +1,2 @@
+import type { PerseusCSProgramWidgetOptions } from "../../data-schema";
+export default function getCSProgramPublicWidgetOptions(options: PerseusCSProgramWidgetOptions): PerseusCSProgramWidgetOptions;

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

@@ -0,0 +1,5 @@
+import type { PerseusCSProgramWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type CSProgramDefaultWidgetOptions = Pick<PerseusCSProgramWidgetOptions, "programID" | "programType" | "settings" | "showEditor" | "showButtons" | "height">;
+declare const csProgramWidgetLogic: WidgetLogic;
+export default csProgramWidgetLogic;

package/dist/widgets/definition/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusDefinitionWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type DefinitionDefaultWidgetOptions = Pick<PerseusDefinitionWidgetOptions, "togglePrompt" | "definition">;
+declare const definitionWidgetLogic: WidgetLogic;
+export default definitionWidgetLogic;

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

@@ -0,0 +1,20 @@
+import type { PerseusDropdownWidgetOptions } from "@khanacademy/perseus-core";
+/**
+ * For details on the individual options, see the
+ * PerseusDropdownWidgetOptions type
+ */
+export type DropdownPublicWidgetOptions = {
+    choices: ReadonlyArray<{
+        content: string;
+    }>;
+    placeholder: PerseusDropdownWidgetOptions["placeholder"];
+    static: PerseusDropdownWidgetOptions["static"];
+    visibleLabel?: PerseusDropdownWidgetOptions["visibleLabel"];
+    ariaLabel?: PerseusDropdownWidgetOptions["ariaLabel"];
+};
+/**
+ * Given a PerseusDropdownWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+declare function getDropdownPublicWidgetOptions(options: PerseusDropdownWidgetOptions): DropdownPublicWidgetOptions;
+export default getDropdownPublicWidgetOptions;

package/dist/widgets/dropdown/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusDropdownWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type DropdownDefaultWidgetOptions = Pick<PerseusDropdownWidgetOptions, "placeholder" | "choices">;
+declare const dropdownWidgetLogic: WidgetLogic;
+export default dropdownWidgetLogic;

package/dist/widgets/explanation/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusExplanationWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type ExplanationDefaultWidgetOptions = Pick<PerseusExplanationWidgetOptions, "showPrompt" | "hidePrompt" | "explanation" | "widgets">;
+declare const explanationWidgetLogic: WidgetLogic;
+export default explanationWidgetLogic;

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

@@ -0,0 +1,10 @@
+import type { PerseusExpressionWidgetOptions } from "../../data-schema";
+export declare const currentVersion: {
+    major: number;
+    minor: number;
+};
+export declare const widgetOptionsUpgrades: {
+    readonly "1": (v0options: any) => PerseusExpressionWidgetOptions;
+};
+export type ExpressionDefaultWidgetOptions = Pick<PerseusExpressionWidgetOptions, "answerForms" | "times" | "buttonSets" | "functions">;
+export declare const defaultWidgetOptions: ExpressionDefaultWidgetOptions;

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

@@ -0,0 +1,19 @@
+import type { PerseusExpressionWidgetOptions } from "@khanacademy/perseus-core";
+/**
+ * For details on the individual options, see the
+ * PerseusExpressionWidgetOptions type
+ */
+type ExpressionPublicWidgetOptions = {
+    buttonSets: PerseusExpressionWidgetOptions["buttonSets"];
+    functions: PerseusExpressionWidgetOptions["functions"];
+    times: PerseusExpressionWidgetOptions["times"];
+    visibleLabel?: PerseusExpressionWidgetOptions["visibleLabel"];
+    ariaLabel?: PerseusExpressionWidgetOptions["ariaLabel"];
+    buttonsVisible?: PerseusExpressionWidgetOptions["buttonsVisible"];
+};
+/**
+ * Given a PerseusExpressionWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+declare function getExpressionPublicWidgetOptions(options: PerseusExpressionWidgetOptions): ExpressionPublicWidgetOptions;
+export default getExpressionPublicWidgetOptions;

package/dist/widgets/expression/index.d.ts

@@ -0,0 +1,4 @@
+import type { WidgetLogic } from "../logic-export.types";
+export type { ExpressionDefaultWidgetOptions } from "./expression-upgrade";
+declare const expressionWidgetLogic: WidgetLogic;
+export default expressionWidgetLogic;

package/dist/widgets/graded-group/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusGradedGroupWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type GradedGroupDefaultWidgetOptions = Pick<PerseusGradedGroupWidgetOptions, "title" | "content" | "widgets" | "images" | "hint">;
+declare const gradedGroupWidgetLogic: WidgetLogic;
+export default gradedGroupWidgetLogic;

package/dist/widgets/graded-group-set/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusGradedGroupSetWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type GradedGroupSetDefaultWidgetOptions = Pick<PerseusGradedGroupSetWidgetOptions, "gradedGroups">;
+declare const gradedGroupSetWidgetLogic: WidgetLogic;
+export default gradedGroupSetWidgetLogic;

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

@@ -0,0 +1,4 @@
+import type { PerseusGrapherWidgetOptions } from "../../data-schema";
+type GrapherPublicWidgetOptions = Pick<PerseusGrapherWidgetOptions, "availableTypes" | "graph">;
+export default function getGrapherPublicWidgetOptions(options: PerseusGrapherWidgetOptions): GrapherPublicWidgetOptions;
+export {};

package/dist/widgets/grapher/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusGrapherWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type GrapherDefaultWidgetOptions = Pick<PerseusGrapherWidgetOptions, "graph" | "correct" | "availableTypes">;
+declare const grapherWidgetLogic: WidgetLogic;
+export default grapherWidgetLogic;

package/dist/widgets/group/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusGroupWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type GroupDefaultWidgetOptions = Pick<PerseusGroupWidgetOptions, "content" | "widgets" | "images">;
+declare const groupWidgetLogic: WidgetLogic;
+export default groupWidgetLogic;

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

@@ -0,0 +1,2 @@
+import type { PerseusIFrameWidgetOptions } from "../../data-schema";
+export default function getIFramePublicWidgetOptions(options: PerseusIFrameWidgetOptions): PerseusIFrameWidgetOptions;

package/dist/widgets/iframe/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusIFrameWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type IFrameDefaultWidgetOptions = Pick<PerseusIFrameWidgetOptions, "url" | "settings" | "width" | "height" | "allowFullScreen" | "allowTopNavigation">;
+declare const iframeWidgetLogic: WidgetLogic;
+export default iframeWidgetLogic;

package/dist/widgets/image/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusImageWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type ImageDefaultWidgetOptions = Pick<PerseusImageWidgetOptions, "title" | "range" | "box" | "backgroundImage" | "labels" | "alt" | "caption">;
+declare const imageWidgetLogic: WidgetLogic;
+export default imageWidgetLogic;

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

@@ -0,0 +1,5 @@
+import type { PerseusInputNumberWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type InputNumberDefaultWidgetOptions = Pick<PerseusInputNumberWidgetOptions, "value" | "simplify" | "size" | "inexact" | "maxError" | "answerType" | "rightAlign">;
+declare const inputNumberWidgetLogic: WidgetLogic;
+export default inputNumberWidgetLogic;

package/dist/widgets/interaction/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusInteractionWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type InteractionDefaultWidgetOptions = Pick<PerseusInteractionWidgetOptions, "graph" | "elements">;
+declare const interactionWidgetLogic: WidgetLogic;
+export default interactionWidgetLogic;

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

@@ -0,0 +1,5 @@
+import type { PerseusInteractiveGraphWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type InteractiveGraphDefaultWidgetOptions = Pick<PerseusInteractiveGraphWidgetOptions, "labels" | "range" | "step" | "backgroundImage" | "markings" | "showTooltips" | "showProtractor" | "graph" | "correct">;
+declare const interactiveGraphWidgetLogic: WidgetLogic;
+export default interactiveGraphWidgetLogic;

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

@@ -0,0 +1,3 @@
+import type { PerseusInteractiveGraphWidgetOptions } from "@khanacademy/perseus-core";
+export type InteractiveGraphPublicWidgetOptions = Pick<PerseusInteractiveGraphWidgetOptions, "step" | "gridStep" | "snapStep" | "backgroundImage" | "markings" | "labels" | "showProtractor" | "showRuler" | "showTooltips" | "rulerLabel" | "rulerTicks" | "range" | "graph" | "lockedFigures" | "fullGraphAriaLabel" | "fullGraphAriaDescription">;
+export default function getInteractiveGraphPublicWidgetOptions(options: PerseusInteractiveGraphWidgetOptions): InteractiveGraphPublicWidgetOptions;

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

@@ -0,0 +1,5 @@
+import type { PerseusLabelImageWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type LabelImageDefaultWidgetOptions = Pick<PerseusLabelImageWidgetOptions, "choices" | "imageAlt" | "imageUrl" | "imageWidth" | "imageHeight" | "markers" | "multipleAnswers" | "hideChoicesFromInstructions">;
+declare const labelImageWidgetLogic: WidgetLogic;
+export default labelImageWidgetLogic;

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

@@ -0,0 +1,19 @@
+import type { PerseusLabelImageMarker, PerseusLabelImageWidgetOptions } from "@khanacademy/perseus-core";
+/**
+ * For details on the individual options, see the
+ * PerseusLabelImageWidgetOptions type
+ */
+type LabelImagePublicWidgetOptions = {
+    choices: PerseusLabelImageWidgetOptions["choices"];
+    imageUrl: PerseusLabelImageWidgetOptions["imageUrl"];
+    imageAlt: PerseusLabelImageWidgetOptions["imageAlt"];
+    imageHeight: PerseusLabelImageWidgetOptions["imageHeight"];
+    imageWidth: PerseusLabelImageWidgetOptions["imageWidth"];
+    markers: ReadonlyArray<LabelImageMarkerPublicData>;
+    hideChoicesFromInstructions: PerseusLabelImageWidgetOptions["hideChoicesFromInstructions"];
+    multipleAnswers: PerseusLabelImageWidgetOptions["multipleAnswers"];
+    static: PerseusLabelImageWidgetOptions["static"];
+};
+type LabelImageMarkerPublicData = Pick<PerseusLabelImageMarker, "x" | "y" | "label">;
+export default function getLabelImagePublicWidgetOptions(options: PerseusLabelImageWidgetOptions): LabelImagePublicWidgetOptions;
+export {};

package/dist/widgets/logic-export.types.d.ts

@@ -0,0 +1,42 @@
+import type getCategorizerPublicWidgetOptions from "./categorizer/categorizer-util";
+import type getCSProgramPublicWidgetOptions from "./cs-program/cs-program-util";
+import type getDropdownPublicWidgetOptions from "./dropdown/dropdown-util";
+import type getExpressionPublicWidgetOptions from "./expression/expression-util";
+import type getGrapherPublicWidgetOptions from "./grapher/grapher-util";
+import type getIFramePublicWidgetOptions from "./iframe/iframe-util";
+import type getInteractiveGraphPublicWidgetOptions from "./interactive-graph/interactive-graph-util";
+import type getLabelImagePublicWidgetOptions from "./label-image/label-image-util";
+import type getMatcherPublicWidgetOptions from "./matcher/matcher-util";
+import type getMatrixPublicWidgetOptions from "./matrix/matrix-util";
+import type getNumberLinePublicWidgetOptions from "./number-line/number-line-util";
+import type getNumericInputPublicWidgetOptions from "./numeric-input/numeric-input-util";
+import type getOrdererPublicWidgetOptions from "./orderer/orderer-util";
+import type getPlotterPublicWidgetOptions from "./plotter/plotter-util";
+import type getRadioPublicWidgetOptions from "./radio/radio-util";
+import type getSorterPublicWidgetOptions from "./sorter/sorter-util";
+import type getTablePublicWidgetOptions from "./table/table-util";
+import type { Version } from "../data-schema";
+import type { Alignment } from "../types";
+export type WidgetOptionsUpgradeMap = {
+    [targetMajorVersion: string]: (arg1: any) => any;
+};
+/**
+ * A union type of all the functions that provide public widget options.
+ *
+ * TODO(LEMS-2870): figure out how to make this generic so we don't need to be
+ * so reliant on a set group of widgets
+ */
+export type PublicWidgetOptionsFunction = typeof getMatcherPublicWidgetOptions | typeof getPlotterPublicWidgetOptions | typeof getIFramePublicWidgetOptions | typeof getRadioPublicWidgetOptions | typeof getNumericInputPublicWidgetOptions | typeof getDropdownPublicWidgetOptions | typeof getCategorizerPublicWidgetOptions | typeof getOrdererPublicWidgetOptions | typeof getExpressionPublicWidgetOptions | typeof getInteractiveGraphPublicWidgetOptions | typeof getLabelImagePublicWidgetOptions | typeof getSorterPublicWidgetOptions | typeof getCSProgramPublicWidgetOptions | typeof getNumberLinePublicWidgetOptions | typeof getTablePublicWidgetOptions | typeof getGrapherPublicWidgetOptions | typeof getMatrixPublicWidgetOptions;
+export type WidgetLogic = {
+    name: string;
+    version?: Version;
+    widgetOptionsUpgrades?: WidgetOptionsUpgradeMap;
+    defaultWidgetOptions?: any;
+    supportedAlignments?: ReadonlyArray<Alignment>;
+    defaultAlignment?: Alignment;
+    /**
+     * A function that provides a public version of the widget options that can
+     * be shared with the client.
+     */
+    getPublicWidgetOptions?: PublicWidgetOptionsFunction;
+};

package/dist/widgets/matcher/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusMatcherWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type MatcherDefaultWidgetOptions = Pick<PerseusMatcherWidgetOptions, "left" | "right" | "labels" | "orderMatters" | "padding">;
+declare const matcherWidgetLogic: WidgetLogic;
+export default matcherWidgetLogic;

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

@@ -0,0 +1,28 @@
+import type { PerseusMatcherWidgetOptions } from "@khanacademy/perseus-core";
+type MatcherInfo = {
+    left: ReadonlyArray<string>;
+    right: ReadonlyArray<string>;
+    orderMatters: boolean;
+    problemNum: number | null | undefined;
+};
+export declare const shuffleMatcher: (props: MatcherInfo) => {
+    left: ReadonlyArray<string>;
+    right: ReadonlyArray<string>;
+};
+/**
+ * For details on the individual options, see the
+ * PerseusMatcherWidgetOptions type
+ */
+type MatcherPublicWidgetOptions = {
+    labels: PerseusMatcherWidgetOptions["labels"];
+    left: PerseusMatcherWidgetOptions["left"];
+    right: PerseusMatcherWidgetOptions["right"];
+    orderMatters: PerseusMatcherWidgetOptions["orderMatters"];
+    padding: PerseusMatcherWidgetOptions["padding"];
+};
+/**
+ * Given a PerseusMatcherWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+declare function getMatcherPublicWidgetOptions(options: PerseusMatcherWidgetOptions): MatcherPublicWidgetOptions;
+export default getMatcherPublicWidgetOptions;

package/dist/widgets/matrix/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusMatrixWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type MatrixDefaultWidgetOptions = Pick<PerseusMatrixWidgetOptions, "matrixBoardSize" | "answers" | "prefix" | "suffix" | "cursorPosition">;
+declare const matrixWidgetLogic: WidgetLogic;
+export default matrixWidgetLogic;

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

@@ -0,0 +1,4 @@
+import type { PerseusMatrixWidgetOptions } from "@khanacademy/perseus-core";
+type MatrixPublicWidgetOptions = Pick<PerseusMatrixWidgetOptions, "prefix" | "suffix" | "cursorPosition" | "matrixBoardSize" | "static">;
+export default function getMatrixPublicWidgetOptions(options: PerseusMatrixWidgetOptions): MatrixPublicWidgetOptions;
+export {};

package/dist/widgets/measurer/index.d.ts

@@ -0,0 +1,4 @@
+import type { WidgetLogic } from "../logic-export.types";
+export type { MeasurerDefaultWidgetOptions } from "./measurer-upgrade";
+declare const measurerWidgetLogic: WidgetLogic;
+export default measurerWidgetLogic;

package/dist/widgets/measurer/measurer-upgrade.d.ts

@@ -0,0 +1,10 @@
+import type { PerseusMeasurerWidgetOptions } from "../../data-schema";
+export declare const currentVersion: {
+    major: number;
+    minor: number;
+};
+export declare const widgetOptionsUpgrades: {
+    readonly "1": (v0options: any) => PerseusMeasurerWidgetOptions;
+};
+export type MeasurerDefaultWidgetOptions = Pick<PerseusMeasurerWidgetOptions, "box" | "image" | "showProtractor" | "showRuler" | "rulerLabel" | "rulerTicks" | "rulerPixels" | "rulerLength">;
+export declare const defaultWidgetOptions: MeasurerDefaultWidgetOptions;

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

@@ -0,0 +1,5 @@
+import type { PerseusNumberLineWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type NumberLineDefaultWidgetOptions = Pick<PerseusNumberLineWidgetOptions, "range" | "labelRange" | "labelStyle" | "labelTicks" | "divisionRange" | "numDivisions" | "snapDivisions" | "tickStep" | "correctRel" | "correctX" | "initialX" | "showTooltips">;
+declare const numberLineWidgetLogic: WidgetLogic;
+export default numberLineWidgetLogic;

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

@@ -0,0 +1,4 @@
+import type { PerseusNumberLineWidgetOptions } from "../../data-schema";
+type NumberLinePublicWidgetOptions = Pick<PerseusNumberLineWidgetOptions, "range" | "labelRange" | "labelStyle" | "labelTicks" | "isTickCtrl" | "divisionRange" | "numDivisions" | "snapDivisions" | "tickStep" | "initialX" | "showTooltips" | "static">;
+export default function getNumberLinePublicWidgetOptions(options: PerseusNumberLineWidgetOptions): NumberLinePublicWidgetOptions;
+export {};

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

@@ -0,0 +1,5 @@
+import type { PerseusNumericInputWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type NumericInputDefaultWidgetOptions = Pick<PerseusNumericInputWidgetOptions, "answers" | "size" | "coefficient" | "labelText" | "rightAlign">;
+declare const numericInputWidgetLogic: WidgetLogic;
+export default numericInputWidgetLogic;

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

@@ -0,0 +1,19 @@
+import type { PerseusNumericInputWidgetOptions } from "@khanacademy/perseus-core";
+/**
+ * For details on the individual options, see the
+ * PerseusNumericInputWidgetOptions type
+ */
+type NumericInputPublicWidgetOptions = {
+    labelText?: PerseusNumericInputWidgetOptions["labelText"];
+    size: PerseusNumericInputWidgetOptions["size"];
+    coefficient: PerseusNumericInputWidgetOptions["coefficient"];
+    rightAlign?: PerseusNumericInputWidgetOptions["rightAlign"];
+    static: PerseusNumericInputWidgetOptions["static"];
+    answerForms?: PerseusNumericInputWidgetOptions["answerForms"];
+};
+/**
+ * Given a PerseusNumericInputWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+declare function getNumericInputPublicWidgetOptions(options: PerseusNumericInputWidgetOptions): NumericInputPublicWidgetOptions;
+export default getNumericInputPublicWidgetOptions;

package/dist/widgets/orderer/index.d.ts

@@ -0,0 +1,5 @@
+import type { PerseusOrdererWidgetOptions } from "../../data-schema";
+import type { WidgetLogic } from "../logic-export.types";
+export type OrdererDefaultWidgetOptions = Pick<PerseusOrdererWidgetOptions, "correctOptions" | "otherOptions" | "height" | "layout">;
+declare const ordererWidgetLogic: WidgetLogic;
+export default ordererWidgetLogic;

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

@@ -0,0 +1,16 @@
+import type { PerseusOrdererWidgetOptions } from "@khanacademy/perseus-core";
+/**
+ * For details on the individual options, see the
+ * PerseusOrdererWidgetOptions type
+ */
+type OrdererPublicWidgetOptions = {
+    options: PerseusOrdererWidgetOptions["options"];
+    height: PerseusOrdererWidgetOptions["height"];
+    layout: PerseusOrdererWidgetOptions["layout"];
+};
+/**
+ * Given a PerseusOrdererWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+declare function getOrdererPublicWidgetOptions(options: PerseusOrdererWidgetOptions): OrdererPublicWidgetOptions;
+export default getOrdererPublicWidgetOptions;