@khanacademy/perseus 74.0.2 → 75.0.0

package/dist/testing/article-renderer-with-debug-ui.d.ts

@@ -0,0 +1,16 @@
+import * as React from "react";
+import type { APIOptions } from "../types";
+import type { PerseusArticle } from "@khanacademy/perseus-core";
+import type { LinterContextProps } from "@khanacademy/perseus-linter";
+type Props = {
+    title?: string;
+    /**
+     * The Perseus Article to render. Under the hood this has been named
+     * `json`, but it is the article. Trust me.
+     */
+    json: PerseusArticle;
+    apiOptions?: APIOptions;
+    linterContext?: LinterContextProps;
+};
+export declare const ArticleRendererWithDebugUI: ({ title, json, apiOptions, linterContext, }: Props) => React.ReactElement;
+export {};

package/dist/testing/debug-accordion-ui.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+import type { PerseusItem, PerseusScore, UserInputMap } from "@khanacademy/perseus-core";
+type DebugAccordionUIProps = {
+    score: PerseusScore | undefined;
+    userInput: UserInputMap | undefined;
+    perseusItem: PerseusItem;
+    updateJson: (json: string) => boolean;
+};
+/**
+ * A component that renders the debug accordion UI for Perseus items
+ */
+export declare const DebugAccordionUI: ({ score, userInput, perseusItem, updateJson, }: DebugAccordionUIProps) => React.ReactElement;
+export {};

package/dist/testing/debug-check-answer-footer.d.ts

@@ -0,0 +1,20 @@
+import * as React from "react";
+import type { PerseusScore, ShowSolutions } from "@khanacademy/perseus-core";
+type DebugCheckAnswerFooterProps = {
+    score: PerseusScore | undefined;
+    showSolutions: ShowSolutions;
+    popover: {
+        isOpen: boolean;
+        setOpen: (open: boolean) => void;
+    };
+    actions: {
+        reset: () => void;
+        skip: () => void;
+        check: () => void;
+    };
+};
+/**
+ * A component that renders the debug check answer footer for Perseus items
+ */
+export declare const DebugCheckAnswerFooter: ({ score, showSolutions, popover, actions, }: DebugCheckAnswerFooterProps) => React.ReactElement;
+export {};

package/dist/testing/debug-header.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+type DebugHeaderProps = {
+    title: string;
+    isMobile: boolean;
+    isRtl: boolean;
+    onToggleMobile: (isMobile: boolean) => void;
+    onToggleRtl: (isRtl: boolean) => void;
+};
+/**
+ * A component that renders the header for the debug UI
+ */
+export declare const DebugHeader: ({ title, isMobile, isRtl, onToggleMobile, onToggleRtl, }: DebugHeaderProps) => React.ReactElement;
+export {};

package/dist/testing/extract-widget-ids-contract-tests.d.ts

@@ -0,0 +1,10 @@
+import type { PerseusRenderer } from "@khanacademy/perseus-core";
+/**
+ * Contract test helper that verifies widget ID extraction implementations
+ * produce identical results. Tests both the Renderer component method and
+ * the standalone utility function against the same scenarios to ensure
+ * behavioral consistency.
+ */
+export declare function testWidgetIdExtraction(name: string, runExtractor: (r: PerseusRenderer, options?: {
+    inline?: boolean;
+}) => readonly string[]): void;

package/dist/testing/feature-flags-util.d.ts

@@ -0,0 +1,15 @@
+declare const DEFAULT_FEATURE_FLAGS: {
+    "new-radio-widget": boolean;
+    "image-widget-upgrade": boolean;
+    "image-widget-upgrade-alignment": boolean;
+};
+/** Utility to get feature flags with optional overrides for testing.
+ *  sample usage:
+ *  getFeatureFlags({"image-widget-upgrade": true})
+ */
+export declare function getFeatureFlags(overrides?: Partial<typeof DEFAULT_FEATURE_FLAGS>): {
+    "new-radio-widget": boolean;
+    "image-widget-upgrade": boolean;
+    "image-widget-upgrade-alignment": boolean;
+};
+export {};

package/dist/testing/image-loader-utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Mocks image loading done by the ImageLoader component to immediately trigger
+ * the load event.
+ * @returns A function to unmock the image loading
+ */
+export declare const mockImageLoading: (options?: {
+    naturalWidth?: number;
+    naturalHeight?: number;
+}) => () => void;

package/dist/testing/item-renderer-hooks.d.ts

@@ -0,0 +1,51 @@
+import * as React from "react";
+import type { ServerItemRenderer } from "../server-item-renderer";
+import type { APIOptions } from "../types";
+import type { PerseusItem, ShowSolutions } from "@khanacademy/perseus-core";
+/**
+ * Custom hook to manage the Server Item Renderer With Debug UI state
+ */
+export declare const useItemRenderer: (item: PerseusItem, apiOptions?: APIOptions, startAnswerless?: boolean, reviewMode?: boolean, showSolutions?: ShowSolutions) => {
+    ref: React.RefObject<ServerItemRenderer>;
+    state: import("./item-renderer-reducer").ItemRendererState;
+    options: {
+        isMobile: boolean;
+        customKeypad: boolean;
+        showSolutions: ShowSolutions | undefined;
+        interactionCallback: () => void;
+        isArticle?: boolean;
+        onFocusChange?: (newFocusPath: import("..").FocusPath, oldFocusPath: import("..").FocusPath, keypadHeight?: number, focusedElement?: HTMLElement) => unknown;
+        showAlignmentOptions?: boolean;
+        readOnly?: boolean;
+        editingDisabled?: boolean;
+        answerableCallback?: (arg1: boolean) => unknown;
+        getAnotherHint?: () => unknown;
+        imagePlaceholder?: React.ReactNode;
+        widgetPlaceholder?: React.ReactNode;
+        baseElements?: {
+            Link: React.ComponentType<any>;
+        };
+        imagePreloader?: (dimensions: import("../types").Dimensions) => React.ReactNode;
+        trackInteraction?: (args: {
+            type: string;
+            id: string;
+            correct?: boolean;
+        } & Partial<import("../types").TrackingGradedGroupExtraArguments> & Partial<{
+            visible: number;
+        }>) => void;
+        nativeKeypadProxy?: (blur: () => void) => import("@khanacademy/math-input").KeypadAPI;
+        isMobileApp?: boolean;
+        setDrawingAreaAvailable?: (arg1: boolean) => unknown;
+        hintProgressColor?: string;
+        canScrollPage?: boolean;
+        editorChangeDelay?: number;
+        flags?: Record<"new-radio-widget" | "image-widget-upgrade" | "image-widget-upgrade-alignment", boolean>;
+    };
+    toggleMobile: (isMobile: boolean) => void;
+    toggleRtl: (isRtl: boolean) => void;
+    updateJson: (json: string) => boolean;
+    handleReset: () => void;
+    handleSkip: () => void;
+    handleCheck: () => void;
+    setShowPopover: (show: boolean) => void;
+};

package/dist/testing/item-renderer-reducer.d.ts

@@ -0,0 +1,48 @@
+import type { PerseusItem, ShowSolutions, PerseusScore, UserInputMap } from "@khanacademy/perseus-core";
+export type ItemRendererState = {
+    isMobile: boolean;
+    isRtl: boolean;
+    perseusItem: PerseusItem;
+    originalItem: PerseusItem;
+    answerless: boolean;
+    startAnswerless: boolean;
+    score: PerseusScore | undefined;
+    userInput: UserInputMap | undefined;
+    showPopover: boolean;
+    showSolutions: ShowSolutions | undefined;
+    hintsVisible: number;
+    key: number;
+    reviewMode: boolean;
+};
+export type ItemRendererAction = {
+    type: "TOGGLE_MOBILE";
+    payload: boolean;
+} | {
+    type: "TOGGLE_RTL";
+    payload: boolean;
+} | {
+    type: "UPDATE_ITEM";
+    payload: PerseusItem;
+} | {
+    type: "SET_SCORE";
+    score: PerseusScore;
+    userInput: UserInputMap;
+} | {
+    type: "TOGGLE_POPOVER";
+    payload: boolean;
+} | {
+    type: "SET_SHOW_SOLUTIONS";
+    payload: ShowSolutions | undefined;
+} | {
+    type: "SET_HINTS_VISIBLE";
+    payload: number;
+} | {
+    type: "SET_ANSWERLESS";
+    payload: boolean;
+} | {
+    type: "RESET_STATE";
+} | {
+    type: "SKIP_TO_SOLUTION";
+};
+export declare const createInitialState: (item: PerseusItem, startAnswerless?: boolean, isMobile?: boolean, isRtl?: boolean, reviewMode?: boolean, showSolutions?: ShowSolutions) => ItemRendererState;
+export declare const itemRendererReducer: (state: ItemRendererState, action: ItemRendererAction) => ItemRendererState;

package/dist/testing/object-utils.d.ts

@@ -0,0 +1 @@
+export declare const clone: <T>(obj: T) => T;

package/dist/testing/render-question-with-cypress.d.ts

@@ -0,0 +1,9 @@
+import * as Perseus from "../index";
+import type { APIOptions } from "../types";
+import type { PerseusRenderer } from "@khanacademy/perseus-core";
+/**
+ * Renders the given question using Cypress. Waits until all assets have been
+ * "rendered/loaded" before it returns.
+ */
+declare const renderQuestion: (question: PerseusRenderer, apiOptions?: APIOptions, reviewMode?: boolean) => (() => Perseus.Renderer);
+export default renderQuestion;

package/dist/testing/server-item-renderer-with-debug-ui.d.ts

@@ -0,0 +1,18 @@
+import * as React from "react";
+import type { APIOptions } from "../types";
+import type { PerseusItem, ShowSolutions } from "@khanacademy/perseus-core";
+import type { LinterContextProps } from "@khanacademy/perseus-linter";
+type Props = {
+    title?: string;
+    item: PerseusItem;
+    apiOptions?: APIOptions;
+    linterContext?: LinterContextProps;
+    startAnswerless?: boolean;
+    reviewMode?: boolean;
+    showSolutions?: ShowSolutions;
+};
+/**
+ * ServerItemRendererWithDebugUI is a component that renders a Perseus item with debug UI controls
+ */
+export declare const ServerItemRendererWithDebugUI: ({ title, item, apiOptions, linterContext, reviewMode, startAnswerless, showSolutions, }: Props) => React.ReactElement;
+export {};

package/dist/testing/split-view.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+type Props = {
+    rendererTitle: React.ReactNode;
+    renderer: React.ReactNode;
+    JSONTitle?: string;
+    jsonObject: any;
+};
+/**
+ * This component is used in Storybook to render both the renderer and the JSON object in a split view.
+ * Currently, the renderer is displayed above the JSON object.
+ */
+declare const SplitView: ({ rendererTitle, renderer, JSONTitle, jsonObject, }: Props) => React.ReactElement;
+export default SplitView;

package/dist/testing/test-dependencies.d.ts

@@ -0,0 +1,7 @@
+import type { PerseusDependencies, PerseusDependenciesV2 } from "../types";
+export declare const testDependencies: PerseusDependencies;
+export declare const testDependenciesV2: PerseusDependenciesV2;
+export declare const storybookTestDependencies: PerseusDependencies;
+export declare const storybookDependenciesV2: PerseusDependenciesV2;
+export declare const cypressTestDependencies: PerseusDependencies;
+export declare const cypressDependenciesV2: PerseusDependenciesV2;

package/dist/testing/test-keypad-context-wrapper.d.ts

@@ -0,0 +1,10 @@
+import * as React from "react";
+type Props = {
+    children: React.ReactElement;
+    /**
+     * Whether we need to offset the keypad to account for the footer.
+     */
+    hasFooter?: boolean;
+};
+declare const TestKeypadContextWrapper: ({ children, hasFooter, }: Props) => React.ReactElement;
+export default TestKeypadContextWrapper;

package/dist/testing/test-mathjax.d.ts

@@ -0,0 +1,10 @@
+import * as React from "react";
+import "@khanacademy/mathjax-renderer/src/css/mathjax.css";
+import "@khanacademy/mathjax-renderer/src/css/safari-hacks.css";
+import "@khanacademy/mathjax-renderer/src/css/selectable.css";
+type Props = {
+    children: string;
+    onRender?: (root?: any) => unknown;
+};
+export declare function TestMathjax({ children: tex, onRender }: Props): React.JSX.Element;
+export {};

package/dist/testing/user-input-ui.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import type { UserInputMap } from "@khanacademy/perseus-core";
+type Props = {
+    userInput: UserInputMap;
+};
+export default function UserInputUI({ userInput }: Props): React.JSX.Element;
+export {};

package/dist/testing/wait.d.ts

@@ -0,0 +1,27 @@
+type WaitOptions = {
+    /**
+     * The time in milliseconds to wait on each wait.
+     * Defaults to 0. Any number less than 0 will be treated as 0.
+     */
+    delay?: number;
+    /**
+     * The number of times to wait.
+     * Defaults to 1. Any number below 1 will be treated as 1.
+     */
+    count?: number;
+};
+/**
+ * Wait for the given delay as many times as indicated.
+ *
+ * This will throw if jest.useRealTimers() is not used.
+ */
+export declare const wait: (options?: WaitOptions) => Promise<void>;
+/**
+ * Waits for the initial Graphie render.
+ *
+ * @returns a Promise<void> that resolves when the Graphie graph has renderred.
+ * The behaviour is undefined if there are multiple Graphies on the page (which
+ * is unlikely in tests).
+ */
+export declare function waitForInitialGraphieRender(): Promise<void>;
+export {};

package/dist/util.d.ts

@@ -69,8 +69,6 @@ declare function gridDimensionConfig(absTickStep: number, extent: Coordinates, d
  *      getGridStep([[-10, 10], [-10, 10]], [1, 1], 340)
  *
  * Returns: [1, 1]
- *
- * TODO(somewhatabstract, FEI-3464): Consolidate query string parsing functions.
  */
 declare function getGridStep(range: [Coordinates, Coordinates], step: Coordinates, boxSize: number): Coordinates;
 declare function snapStepFromGridStep(gridStep: [number, number]): [number, number];

package/dist/widgets/molecule/molecule-layout.d.ts

@@ -17,7 +17,6 @@
  *         convertTree; the computed position of this atom is added to this
  *         object in place, in addition to being returned in the layout
  *         instruction.
- *         TODO(colin): refactor so that we don't need to modify this in place
  *     atoms: the list of all atoms, as returned from convertTree, used to
  *         position this atom appropriately relative to its neighbors
  *     bonds: the list of all bonds, as returned from convertTree, used to

package/package.json

@@ -3,7 +3,7 @@
   "description": "Core Perseus API (includes renderers and widgets)",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "74.0.2",
+  "version": "75.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -42,47 +42,45 @@
     "tiny-invariant": "1.3.1",
     "uuid": "^10.0.0",
     "@khanacademy/kas": "2.1.7",
-    "@khanacademy/keypad-context": "3.2.30",
-    "@khanacademy/kmath": "2.2.30",
-    "@khanacademy/math-input": "26.3.11",
-    "@khanacademy/perseus-core": "23.0.0",
-    "@khanacademy/perseus-linter": "4.7.0",
-    "@khanacademy/perseus-score": "8.2.7",
+    "@khanacademy/keypad-context": "3.2.31",
+    "@khanacademy/kmath": "2.2.31",
+    "@khanacademy/math-input": "26.3.12",
+    "@khanacademy/perseus-core": "23.0.1",
+    "@khanacademy/perseus-linter": "4.7.1",
+    "@khanacademy/perseus-score": "8.2.8",
     "@khanacademy/perseus-utils": "2.1.4",
     "@khanacademy/pure-markdown": "2.2.5",
     "@khanacademy/simple-markdown": "2.2.0"
   },
   "devDependencies": {
     "@khanacademy/wonder-blocks-announcer": "1.0.6",
-    "@khanacademy/wonder-blocks-banner": "5.0.13",
-    "@khanacademy/wonder-blocks-button": "11.3.2",
-    "@khanacademy/wonder-blocks-clickable": "8.1.2",
+    "@khanacademy/wonder-blocks-banner": "5.0.15",
+    "@khanacademy/wonder-blocks-button": "11.3.4",
+    "@khanacademy/wonder-blocks-clickable": "8.1.3",
     "@khanacademy/wonder-blocks-core": "12.4.3",
     "@khanacademy/wonder-blocks-data": "15.0.1",
-    "@khanacademy/wonder-blocks-dropdown": "10.6.7",
-    "@khanacademy/wonder-blocks-form": "7.5.3",
-    "@khanacademy/wonder-blocks-icon-button": "11.1.3",
+    "@khanacademy/wonder-blocks-dropdown": "10.7.1",
+    "@khanacademy/wonder-blocks-form": "7.5.4",
+    "@khanacademy/wonder-blocks-icon-button": "11.1.4",
     "@khanacademy/wonder-blocks-icon": "5.3.7",
     "@khanacademy/wonder-blocks-labeled-field": "4.0.14",
     "@khanacademy/wonder-blocks-layout": "3.1.44",
-    "@khanacademy/wonder-blocks-link": "10.1.3",
-    "@khanacademy/wonder-blocks-modal": "8.5.14",
-    "@khanacademy/wonder-blocks-pill": "3.1.53",
-    "@khanacademy/wonder-blocks-popover": "6.1.52",
+    "@khanacademy/wonder-blocks-link": "10.1.5",
+    "@khanacademy/wonder-blocks-modal": "8.5.15",
+    "@khanacademy/wonder-blocks-pill": "3.1.55",
+    "@khanacademy/wonder-blocks-popover": "6.1.53",
     "@khanacademy/wonder-blocks-progress-spinner": "3.1.44",
-    "@khanacademy/wonder-blocks-switch": "3.3.27",
+    "@khanacademy/wonder-blocks-switch": "3.3.28",
     "@khanacademy/wonder-blocks-timing": "7.0.4",
     "@khanacademy/wonder-blocks-tokens": "15.0.0",
-    "@khanacademy/wonder-blocks-tooltip": "4.1.65",
+    "@khanacademy/wonder-blocks-tooltip": "4.1.66",
     "@khanacademy/wonder-blocks-typography": "4.2.29",
     "@khanacademy/wonder-stuff-core": "3.0.0",
     "@phosphor-icons/core": "2.0.2",
     "@popperjs/core": "2.10.2",
     "aphrodite": "1.2.5",
     "classnames": "1.1.4",
-    "intersection-observer": "^0.12.0",
     "jquery": "2.1.1",
-    "lodash.debounce": "^4.0.8",
     "prop-types": "15.8.1",
     "react": "18.2.0",
     "react-dom": "18.2.0",
@@ -93,35 +91,33 @@
   },
   "peerDependencies": {
     "@khanacademy/wonder-blocks-announcer": "^1.0.6",
-    "@khanacademy/wonder-blocks-banner": "^5.0.13",
-    "@khanacademy/wonder-blocks-button": "^11.3.2",
-    "@khanacademy/wonder-blocks-clickable": "^8.1.2",
+    "@khanacademy/wonder-blocks-banner": "^5.0.15",
+    "@khanacademy/wonder-blocks-button": "^11.3.4",
+    "@khanacademy/wonder-blocks-clickable": "^8.1.3",
     "@khanacademy/wonder-blocks-core": "^12.4.3",
     "@khanacademy/wonder-blocks-data": "^15.0.1",
-    "@khanacademy/wonder-blocks-dropdown": "^10.6.7",
-    "@khanacademy/wonder-blocks-form": "^7.5.3",
+    "@khanacademy/wonder-blocks-dropdown": "^10.7.1",
+    "@khanacademy/wonder-blocks-form": "^7.5.4",
     "@khanacademy/wonder-blocks-icon": "^5.3.7",
-    "@khanacademy/wonder-blocks-icon-button": "^11.1.3",
+    "@khanacademy/wonder-blocks-icon-button": "^11.1.4",
     "@khanacademy/wonder-blocks-labeled-field": "^4.0.14",
     "@khanacademy/wonder-blocks-layout": "^3.1.44",
-    "@khanacademy/wonder-blocks-link": "^10.1.3",
-    "@khanacademy/wonder-blocks-modal": "^8.5.14",
-    "@khanacademy/wonder-blocks-pill": "^3.1.53",
-    "@khanacademy/wonder-blocks-popover": "^6.1.52",
+    "@khanacademy/wonder-blocks-link": "^10.1.5",
+    "@khanacademy/wonder-blocks-modal": "^8.5.15",
+    "@khanacademy/wonder-blocks-pill": "^3.1.55",
+    "@khanacademy/wonder-blocks-popover": "^6.1.53",
     "@khanacademy/wonder-blocks-progress-spinner": "^3.1.44",
-    "@khanacademy/wonder-blocks-switch": "^3.3.27",
+    "@khanacademy/wonder-blocks-switch": "^3.3.28",
     "@khanacademy/wonder-blocks-timing": "^7.0.4",
     "@khanacademy/wonder-blocks-tokens": "^15.0.0",
-    "@khanacademy/wonder-blocks-tooltip": "^4.1.65",
+    "@khanacademy/wonder-blocks-tooltip": "^4.1.66",
     "@khanacademy/wonder-blocks-typography": "^4.2.29",
     "@khanacademy/wonder-stuff-core": "^3.0.0",
     "@phosphor-icons/core": "^2.0.2",
     "@popperjs/core": "^2.10.2",
     "aphrodite": "^1.2.5",
     "classnames": "^1.1.4",
-    "intersection-observer": "^0.12.0",
     "jquery": "^2.1.1",
-    "lodash.debounce": "^4.0.8",
     "prop-types": "^15.8.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
@@ -130,7 +126,7 @@
   },
   "keywords": [],
   "khan": {
-    "catalogHash": "cfe9661d5f76c8a2"
+    "catalogHash": "cb75588f4bb498b6"
   },
   "scripts": {}
 }

package/dist/renderability.d.ts

@@ -1 +0,0 @@
-export declare const isItemRenderableByVersion: (itemData: any, rendererContentVersion: any) => boolean;