@khanacademy/perseus-core 13.0.0 → 14.0.1

package/dist/parse-perseus-json/perseus-parsers/expression-widget.d.ts

@@ -1,8 +1,8 @@
 export declare const parseExpressionWidget: import("../parser-types").Parser<import("../..").WidgetOptions<"expression", import("../general-purpose-parsers/object-types").OptionalizeProperties<{
     answerForms: {
         value: string;
-        form: boolean;
         simplify: boolean;
+        form: boolean;
         considered: "correct" | "wrong" | "ungraded";
         key?: string | undefined;
     }[];

package/dist/parse-perseus-json/perseus-parsers/group-user-input.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusGroupUserInput } from "../../validation.types";
+import type { Parser } from "../parser-types";
+export declare const parseGroupUserInput: Parser<PerseusGroupUserInput>;

package/dist/parse-perseus-json/perseus-parsers/group-user-input.typetest.d.ts

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

package/dist/parse-perseus-json/perseus-parsers/user-input-map.d.ts

@@ -0,0 +1,17 @@
+import type { UserInputMap } from "../../validation.types";
+import type { Parser } from "../parser-types";
+/**
+ * Parses a UserInputMap, which is a map of widget IDs to their corresponding user input data.
+ *
+ * A UserInputMap maps widget IDs (like "radio 1", "dropdown 2") to the user input data
+ * for each widget. This is used by Group widgets and other contexts where multiple
+ * widgets need to be tracked together.
+ *
+ * The parser handles recursive structures since Group widgets can contain other Group
+ * widgets, each with their own UserInputMap.
+ *
+ * @param rawValue - The raw value to parse, expected to be a plain object
+ * @param ctx - The parse context for error reporting and tracking
+ * @returns A ParseResult containing either the parsed UserInputMap or an error
+ */
+export declare const parseUserInputMap: Parser<UserInputMap>;

package/dist/parse-perseus-json/perseus-parsers/widget-id-components.d.ts

@@ -0,0 +1,27 @@
+import type { Parser } from "../parser-types";
+/**
+ * Parses a string representation of a non-negative integer.
+ *
+ * This parser is used for the numeric part of widget IDs (e.g., the "1" in "radio 1").
+ * It accepts string representations of non-negative integers, including "0".
+ *
+ * Note: The article renderer allows widget IDs with 0 (at least for image widgets),
+ * but if widget IDs in an exercise contain 0, the exercise renderer may have issues.
+ * We allow 0 here for compatibility with articles.
+ *
+ * @param rawValue - The raw value to parse, expected to be a string
+ * @param ctx - The parse context for error reporting
+ * @returns A ParseResult containing either the parsed number or an error
+ */
+export declare const parseStringToNonNegativeInt: Parser<number>;
+/**
+ * Parses widget ID components into a [type, number] tuple.
+ *
+ * Widget IDs in Perseus follow the format "{type} {number}" (e.g., "radio 1", "dropdown 2").
+ * This parser takes the components of a widget ID (after splitting on spaces) and
+ * validates that it consists of exactly two parts: a widget type string and a
+ * non-negative integer.
+ *
+ * @type {Parser<[string, number]>} A parser that returns a tuple of [widgetType, widgetNumber]
+ */
+export declare const parseWidgetIdComponents: Parser<[string, number]>;

package/dist/traversal.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Traverses a {content, widgets, images} renderer props object,
+ * such as `itemData.question`
+ *
+ * This traversal is deep and handles some widget prop upgrades
+ * (TODO(aria): Handle minor prop upgrades :) )
+ *
+ * This is the right way to traverse itemData.
+ *
+ * NOTE: We should not expose this on the perseus API yet. Instead,
+ * build the traversal method you want inside perseus, and use this
+ * from that. We might eventually expose this, but I'd like to be
+ * more confident in the interface provided first.
+ */
+import type { PerseusRenderer } from "./data-schema";
+export declare const traverse: (rendererOptions: PerseusRenderer, contentCallback?: ((arg1: any) => any) | null, widgetCallback?: ((widgetInfo: any, widgetId: string) => any) | null, optionsCallback?: (arg1: any) => void) => any;

package/dist/utils/util.graphie.d.ts

@@ -0,0 +1,6 @@
+export declare function getRealImageUrl(graphieUrl: string): string;
+export declare function isLabeledSVG(graphieUrl: string): boolean;
+export declare function getBaseUrl(graphieUrl: string): string;
+export declare function getSvgUrl(graphieUrl: string): string;
+export declare function getDataUrl(graphieUrl: string): string;
+export declare function getImageSizeModern(url: string): Promise<[number, number]>;

package/dist/validation.types.d.ts

@@ -168,6 +168,7 @@ export type PerseusPlotterValidationData = {
 export type PerseusPlotterUserInput = number[];
 export type PerseusRadioRubric = {
     choices: PerseusRadioChoice[];
+    countChoices?: boolean;
 };
 export type PerseusRadioUserInput = {
     choicesSelected: boolean[];

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

@@ -1,9 +1,13 @@
-import type { PublicWidgetOptionsFunction } from "./logic-export.types";
+import type { PublicWidgetOptionsFunction, WidgetLogic } from "./logic-export.types";
+import type { PerseusWidgetOptions, PerseusWidget } from "../data-schema";
 import type { Alignment } from "../types";
+export declare function registerWidget(type: string, logic: WidgetLogic): void;
 export declare function isWidgetRegistered(type: string): boolean;
 export declare function getCurrentVersion(type: string): import("..").Version;
 export declare const getPublicWidgetOptionsFunction: (type: string) => PublicWidgetOptionsFunction;
 export declare function getDefaultWidgetOptions(type: string): any;
+export declare function isAccessible(type: string, widgetOptions: PerseusWidgetOptions): boolean;
+export declare const traverseChildWidgets: (widgetInfo: PerseusWidget, traverseRenderer: any) => PerseusWidget;
 /**
  * Handling for the optional alignments for widgets
  * See widget-container.jsx for details on how alignments are implemented.

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

@@ -18,7 +18,7 @@ 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 { PerseusWidgetOptions, Version } from "../data-schema";
 import type { Alignment } from "../types";
 export type WidgetOptionsUpgradeMap = {
     [targetMajorVersion: string]: (arg1: any) => any;
@@ -36,6 +36,8 @@ export type WidgetLogic = {
     defaultWidgetOptions?: any;
     supportedAlignments?: ReadonlyArray<Alignment>;
     defaultAlignment?: Alignment;
+    accessible?: boolean | ((options: PerseusWidgetOptions) => boolean);
+    traverseChildWidgets?: (props: any, traverseRenderer: any) => any;
     /**
      * A function that provides a public version of the widget options that can
      * be shared with the client.

package/package.json

@@ -3,7 +3,7 @@
   "description": "Shared Perseus infrastructure",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "13.0.0",
+  "version": "14.0.1",
   "publishConfig": {
     "access": "public"
   },
@@ -23,13 +23,13 @@
   ],
   "dependencies": {
     "tiny-invariant": "1.3.1",
-    "@khanacademy/kas": "2.0.5",
+    "@khanacademy/kas": "2.0.6",
     "@khanacademy/perseus-utils": "2.0.4"
   },
   "devDependencies": {
     "@khanacademy/wonder-stuff-core": "1.5.4",
     "underscore": "1.4.4",
-    "perseus-build-settings": "0.6.2"
+    "perseus-build-settings": "0.7.0"
   },
   "peerDependencies": {
     "@khanacademy/wonder-stuff-core": "^1.5.4",