@khanacademy/perseus 77.1.0 → 77.2.0

package/dist/widgets/interactive-graphs/graphs/logarithm.d.ts

@@ -0,0 +1,12 @@
+import { type I18nContextType } from "../../../components/i18n-context";
+import type { LogarithmGraphState, Dispatch, InteractiveGraphElementSuite } from "../types";
+import type { Coord } from "@khanacademy/perseus-core";
+import type { Interval, vec } from "mafs";
+export declare function renderLogarithmGraph(state: LogarithmGraphState, dispatch: Dispatch, i18n: I18nContextType): InteractiveGraphElementSuite;
+export declare const constrainAsymptoteKeyboard: (p: vec.Vector2, coords: ReadonlyArray<Coord>, snapStep: vec.Vector2) => vec.Vector2;
+export declare const getLogarithmKeyboardConstraint: (coords: ReadonlyArray<Coord>, asymptote: number, snapStep: vec.Vector2, pointIndex: number, range: [Interval, Interval]) => {
+    up: vec.Vector2;
+    down: vec.Vector2;
+    left: vec.Vector2;
+    right: vec.Vector2;
+};

package/dist/widgets/interactive-graphs/graphs/utils.d.ts

@@ -36,3 +36,28 @@ export declare function getPolygonSideString(sideLength: number, pointIndex: num
  * The radius scales with the range so it's visible at all graph sizes.
  */
 export declare function calculateScaledRadius(range: [Interval, Interval]): number;
+/**
+ * Shared keyboard constraint logic for asymptote-based graph points
+ * (exponential, logarithm). Computes the next valid position for each
+ * arrow-key direction, skipping up to 3 snap steps to avoid positions
+ * rejected by the caller's `isValidPosition` predicate.
+ *
+ * The per-graph validity rules differ (exponential checks Y vs asymptote and
+ * X vs other point; logarithm checks X vs asymptote and Y vs other point),
+ * so they are injected via the callback.
+ */
+export declare function getAsymptoteGraphKeyboardConstraint(coords: ReadonlyArray<Coord>, snapStep: vec.Vector2, pointIndex: number, isValidPosition: (coord: vec.Vector2) => boolean): {
+    up: vec.Vector2;
+    down: vec.Vector2;
+    left: vec.Vector2;
+    right: vec.Vector2;
+};
+/**
+ * Shared keyboard constraint for asymptote movement (exponential, logarithm).
+ * When the next snapped position would land between or on the curve points,
+ * snaps past all of them in the direction of travel using a midpoint heuristic.
+ *
+ * @param orientation - "horizontal" for exponential (asymptote moves on Y-axis),
+ *   "vertical" for logarithm (asymptote moves on X-axis).
+ */
+export declare function constrainAsymptoteKeyboardMovement(p: vec.Vector2, coords: ReadonlyArray<Coord>, snapStep: vec.Vector2, orientation: "horizontal" | "vertical"): vec.Vector2;

package/dist/widgets/interactive-graphs/interactive-graph-question-builder.d.ts

@@ -130,6 +130,12 @@ declare class InteractiveGraphQuestionBuilder {
         snapDegrees?: number;
         match?: "congruent";
     }): InteractiveGraphQuestionBuilder;
+    withLogarithm(options?: {
+        coords?: [Coord, Coord];
+        asymptote?: number;
+        startCoords?: [Coord, Coord];
+        startAsymptote?: number;
+    }): InteractiveGraphQuestionBuilder;
     withAbsoluteValue(options?: {
         coords?: [Coord, Coord];
         startCoords?: [Coord, Coord];

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

@@ -161,9 +161,9 @@ declare class InteractiveGraph extends React.Component<Props, State> {
         problemNum: number | null | undefined;
         apiOptions: Readonly<Readonly<{
             isArticle?: boolean;
-            onFocusChange?: (newFocusPath: import("../..").FocusPath, oldFocusPath: import("../..").FocusPath, keypadHeight? /**
+            onFocusChange?: (newFocusPath: import("../..").FocusPath, oldFocusPath: import("../..").FocusPath, keypadHeight?: number, focusedElement? /**
              * Whether to show the arrows on the axis.
-             */: number, focusedElement?: HTMLElement) => unknown;
+             */: HTMLElement) => unknown;
             showAlignmentOptions?: boolean;
             readOnly?: boolean;
             editingDisabled?: boolean;
@@ -261,6 +261,8 @@ declare class InteractiveGraph extends React.Component<Props, State> {
     static getSinusoidEquationString(props: Props): string;
     static defaultExponentialCoords(props: Props): Coord[];
     static getExponentialEquationString(props: Props): string;
+    static defaultLogarithmCoords(props: Props): Coord[];
+    static getLogarithmEquationString(props: Props): string;
     static getAbsoluteValueEquationString(props: Props): string;
     static getCurrentTangentCoefficients(props: Props): TangentCoefficient;
     static defaultTangentCoords(props: Props): Coord[];

package/dist/widgets/interactive-graphs/reducer/initialize-graph-state.d.ts

@@ -1,6 +1,6 @@
 import type { Coord } from "../../../interactive2/types";
 import type { InteractiveGraphState, PairOfPoints } from "../types";
-import type { PerseusGraphType, PerseusGraphTypeAbsoluteValue, PerseusGraphTypeAngle, PerseusGraphTypeCircle, PerseusGraphTypeLinear, PerseusGraphTypeLinearSystem, PerseusGraphTypePoint, PerseusGraphTypePolygon, PerseusGraphTypeQuadratic, PerseusGraphTypeRay, PerseusGraphTypeSegment, PerseusGraphTypeSinusoid, PerseusGraphTypeExponential, PerseusGraphTypeTangent } from "@khanacademy/perseus-core";
+import type { PerseusGraphType, PerseusGraphTypeAbsoluteValue, PerseusGraphTypeAngle, PerseusGraphTypeCircle, PerseusGraphTypeLinear, PerseusGraphTypeLinearSystem, PerseusGraphTypePoint, PerseusGraphTypePolygon, PerseusGraphTypeQuadratic, PerseusGraphTypeRay, PerseusGraphTypeSegment, PerseusGraphTypeSinusoid, PerseusGraphTypeExponential, PerseusGraphTypeTangent, PerseusGraphTypeLogarithm } from "@khanacademy/perseus-core";
 import type { Interval } from "mafs";
 export type InitializeGraphStateParams = {
     range: [x: Interval, y: Interval];
@@ -26,6 +26,10 @@ export declare function getExponentialCoords(graph: PerseusGraphTypeExponential,
     coords: [Coord, Coord];
     asymptote: number;
 };
+export declare function getLogarithmCoords(graph: PerseusGraphTypeLogarithm, range: [x: Interval, y: Interval], step: [x: number, y: number]): {
+    coords: [Coord, Coord];
+    asymptote: number;
+};
 export declare const getAngleCoords: (params: {
     graph: PerseusGraphTypeAngle;
     range: [x: Interval, y: Interval];

package/dist/widgets/interactive-graphs/reducer/interactive-graph-action.d.ts

@@ -60,6 +60,10 @@ export declare const actions: {
         movePoint: typeof movePoint;
         moveCenter: typeof moveCenter;
     };
+    logarithm: {
+        movePoint: typeof movePoint;
+        moveCenter: typeof moveCenter;
+    };
     absoluteValue: {
         movePoint: typeof movePoint;
     };

package/dist/widgets/interactive-graphs/types.d.ts

@@ -15,7 +15,7 @@ export type InteractiveGraphElementSuite = {
     graph: ReactNode;
     interactiveElementsDescription: ReactNode;
 };
-export type InteractiveGraphState = AbsoluteValueGraphState | AngleGraphState | SegmentGraphState | LinearSystemGraphState | LinearGraphState | RayGraphState | NoneGraphState | PolygonGraphState | PointGraphState | CircleGraphState | QuadraticGraphState | SinusoidGraphState | ExponentialGraphState | TangentGraphState;
+export type InteractiveGraphState = AbsoluteValueGraphState | AngleGraphState | SegmentGraphState | LinearSystemGraphState | LinearGraphState | RayGraphState | NoneGraphState | PolygonGraphState | PointGraphState | CircleGraphState | QuadraticGraphState | SinusoidGraphState | ExponentialGraphState | TangentGraphState | LogarithmGraphState;
 export type UnlimitedGraphState = PointGraphState | PolygonGraphState;
 export interface InteractiveGraphStateCommon {
     hasBeenInteractedWith: boolean;
@@ -91,6 +91,12 @@ export interface TangentGraphState extends InteractiveGraphStateCommon {
     type: "tangent";
     coords: [vec.Vector2, vec.Vector2];
 }
+export interface LogarithmGraphState extends InteractiveGraphStateCommon {
+    type: "logarithm";
+    coords: [vec.Vector2, vec.Vector2];
+    /** The x-value of the vertical asymptote (x = asymptote). */
+    asymptote: number;
+}
 export interface AngleGraphState extends InteractiveGraphStateCommon {
     type: "angle";
     showAngles?: boolean;

package/package.json

@@ -3,7 +3,7 @@
   "description": "Core Perseus API (includes renderers and widgets)",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "77.1.0",
+  "version": "77.2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -42,15 +42,15 @@
     "tiny-invariant": "1.3.1",
     "uuid": "^10.0.0",
     "@khanacademy/kas": "2.2.1",
-    "@khanacademy/keypad-context": "3.2.41",
-    "@khanacademy/kmath": "2.3.1",
-    "@khanacademy/math-input": "26.4.12",
-    "@khanacademy/perseus-core": "24.0.0",
-    "@khanacademy/perseus-score": "8.5.0",
+    "@khanacademy/keypad-context": "3.2.42",
+    "@khanacademy/kmath": "2.4.0",
+    "@khanacademy/math-input": "26.4.13",
+    "@khanacademy/perseus-core": "24.1.0",
+    "@khanacademy/perseus-linter": "4.9.2",
+    "@khanacademy/perseus-score": "8.6.0",
     "@khanacademy/perseus-utils": "2.1.5",
     "@khanacademy/pure-markdown": "2.2.7",
-    "@khanacademy/simple-markdown": "2.2.2",
-    "@khanacademy/perseus-linter": "4.9.1"
+    "@khanacademy/simple-markdown": "2.2.2"
   },
   "devDependencies": {
     "@khanacademy/wonder-blocks-announcer": "1.1.0",