[AbsoluteValue] PR2 - state management#3349
Conversation
🗄️ Schema Change: No Changes ✅ |
npm Snapshot: PublishedGood news!! We've packaged up the latest commit from this PR (d1f4f34) and published it to npm. You Example: pnpm add @khanacademy/perseus@PR3349If you are working in Khan Academy's frontend, you can run the below command. ./dev/tools/bump_perseus_version.ts -t PR3349If you are working in Khan Academy's webapp, you can run the below command. ./dev/tools/bump_perseus_version.js -t PR3349 |
🛠️ Item Splitting: No Changes ✅ |
|
Size Change: +109 B (+0.02%) Total Size: 488 kB
ℹ️ View Unchanged
|
There was a problem hiding this comment.
LGTM — straightforward, pattern-following implementation of the absolute-value graph type across existing switch statements and builders.
Extended reasoning...
Overview
This PR fills in the absolute-value graph type implementation across 7 files in the interactive-graphs widget. Every change follows the exact same pattern as existing graph types (sinusoid, quadratic, angle, etc.): replacing throw new Error("Not implemented") stubs with actual case handlers that mirror sibling graph types. The new getAbsoluteValueCoords function, AbsoluteValueGraphConfig builder class, doMovePoint reducer case, getGradableGraph handler, and mafsStateToInteractiveGraph case all follow established conventions precisely.
Security risks
None. The changes are entirely internal graph state management — no user input parsing, no network calls, no auth code, no data exposure vectors.
Level of scrutiny
Low scrutiny is appropriate. This is mechanical, pattern-following code in a widget subsystem. Each new code block is structurally identical to existing cases for other graph types (e.g., the sinusoid case). The feature is also behind a feature flag (per PR #3344). The only filed bug is a nit about a missing package-level re-export, which is explicitly deferred to a later PR in this multi-PR series and has no functional impact (the graph initializes correctly via fallback defaults).
Other factors
The PR is part of a planned multi-PR series (LEMS-3347). PR 1 set up the scaffolding and editor support; this PR 2 implements the core graph reducer/state logic. Test data is included. The PR description is sparse but the code changes are self-explanatory given the established patterns.
| export function getAbsoluteValueCoords( | ||
| graph: PerseusGraphTypeAbsoluteValue, | ||
| range: [x: Interval, y: Interval], | ||
| step: [x: number, y: number], | ||
| ): [Coord, Coord] { | ||
| if (graph.coords) { | ||
| return graph.coords; | ||
| } | ||
|
|
||
| if (graph.startCoords) { | ||
| return graph.startCoords; | ||
| } | ||
|
|
||
| const defaultCoords: [Coord, Coord] = [ | ||
| [0.5, 0.5], | ||
| [0.75, 0.75], | ||
| ]; | ||
|
|
||
| return normalizePoints(range, step, defaultCoords, true); | ||
| } |
There was a problem hiding this comment.
🟡 Nit: getAbsoluteValueCoords is exported from initialize-graph-state.ts but not re-exported from packages/perseus/src/index.ts, unlike every other coord initialization function (getCircleCoords, getLineCoords, etc.). This means the editor's getDefaultGraphStartCoords in util.ts has no absolute-value case and returns undefined. Since this is clearly a multi-PR effort and the editor integration was set up in PR 1, this is likely planned for a later PR — but worth tracking to ensure the export and editor case are added before the feature ships.
Extended reasoning...
What the bug is
getAbsoluteValueCoords is a new function introduced in this PR, exported from initialize-graph-state.ts. However, it is NOT re-exported from packages/perseus/src/index.ts (line 111-121), where all 9 other coord initialization functions (getCircleCoords, getLineCoords, getLinearSystemCoords, getPointCoords, getPolygonCoords, getSegmentCoords, getSinusoidCoords, getQuadraticCoords, getAngleCoords) are exported. This breaks the established pattern.
Downstream impact
The editor utility getDefaultGraphStartCoords in packages/perseus-editor/src/widgets/interactive-graph-editor/start-coords/util.ts computes default start coordinates for each graph type by calling the corresponding coord function. Without the getAbsoluteValueCoords export, there is no "absolute-value" case in the switch statement, so it falls through to default: return undefined (line 91-92). Meanwhile, shouldShowStartCoordsUI at line 195 returns true for absolute-value, so the start coords editor UI IS shown.
Step-by-step proof
- User opens the editor for an absolute-value graph type
shouldShowStartCoordsUIreturnstrue(line 195 of util.ts, added in PR 1)- The start coords UI is displayed with a "Use default start coordinates" button
- User clicks the button, which calls
getDefaultGraphStartCoords - The switch statement has no
"absolute-value"case, falls through todefault: return undefined undefinedis set asstartCoordson the graph config- During graph initialization,
getAbsoluteValueCoordsreceivesgraph.startCoords === undefined, skips the startCoords branch, and computes defaults from scratch - The graph still initializes correctly — the bug is silent
Addressing refutations
Multiple verifiers noted this is intentionally deferred work in a multi-PR series. I agree. The git history confirms: shouldShowStartCoordsUI for absolute-value was added in PR 1 (commit aae4026), not this PR. This PR does not modify util.ts at all. The practical impact is negligible since undefined startCoords triggers the correct default fallback in getAbsoluteValueCoords. The feature is also behind a feature flag (PR #3344).
Why this is a nit, not a bug
This is a pattern inconsistency in an incremental implementation, not a functional bug. The graph initializes correctly either way. However, the export should be added to the package index and the editor case should be completed before the feature flag is removed, to ensure the "Use default start coordinates" button returns explicit computed defaults rather than relying on the accidental undefined fallback.
| return {...originalGraph}; | ||
| case "absolute-value": | ||
| throw new Error("Not implemented: absolute-value graph type"); | ||
| invariant(originalGraph.type === "absolute-value"); |
There was a problem hiding this comment.
Can we add an equivalent test for this logic in packages/perseus/src/widgets/interactive-graphs/mafs-state-to-interactive-graph.test.ts
| return coords; | ||
| } | ||
|
|
||
| function getAbsoluteValueCoords( |
There was a problem hiding this comment.
Can we add a equivalent test for this logic in packages/perseus/src/widgets/interactive-graphs/reducer/initialize-graph-state.test.ts
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: -▶️ [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 Author: handeyeco Reviewers: claude[bot], handeyeco, ivyolamit, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ⏭️ 1 check has been skipped, ✅ 10 checks were successful Pull Request URL: #3346
a4b7bea to
0309b34
Compare
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) -▶️ [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 --- Add type definitions and schema for absolute-value graph type Adds the foundational type scaffolding needed to support an absolute-value graph in the Interactive Graph widget. This is a pure additive change — no runtime behavior is altered and all existing tests continue to pass. Changes: - data-schema.ts — Adds PerseusGraphTypeAbsoluteValue (type: "absolute-value", coords, startCoords) and includes it in the PerseusGraphType union. - interactive-graph-widget.ts — Registers parsePerseusGraphTypeAbsoluteValue with parsePerseusGraphType so the new type round-trips through the parser. - types.ts — Adds AbsoluteValueGraphState (mirrors SinusoidGraphState: vertex + arm point) and adds it to the InteractiveGraphState union. - interactive-graph-ai-utils.ts — Adds AbsoluteValueGraphOptions and AbsoluteValueUserInput types and wires them into getGraphOptionsForProps / getUserInput to satisfy exhaustiveness checks. - Stubs out "absolute-value" cases with throw new Error("Not implemented") in initializeGraphState, mafsStateToInteractiveGraph, renderGraphElements, and getEquationString to keep TypeScript exhaustiveness errors clear until subsequent PRs fill in the implementation. - Adds "absolute-value" to the mergeGraphs switch and shouldShowStartCoordsUI in the editor to satisfy exhaustiveness checks there as well. Author: handeyeco Reviewers: claude[bot], handeyeco, ivyolamit, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ✅ 10 checks were successful, ⏭️ 1 check has been skipped Pull Request URL: #3348
b4bc67b to
d170d04
Compare
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) -▶️ [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 --- Implement rendering and accessibility for absolute-value graph type Adds the visual component, screen reader strings, equation display, and unit tests for the absolute-value graph. Depends on PR 1 + PR 2. After this PR the graph is fully interactive and renderable. Changes: - graphs/absolute-value.tsx (new file) — Implements renderAbsoluteValueGraph, the AbsoluteValueGraph component, and two exported helpers: - getAbsoluteValueCoefficients(coords) — extracts {m, h, v} from the two control points, returning undefined if both share the same x. Uses a coeffRef to cache the last valid result for transient mid-drag states. - getAbsoluteValueKeyboardConstraint(coords, snapStep, pointIndex) — keyboard movement constraint that skips any position where the moved point would share an x-coordinate with the other point. - Renders a single <Plot.OfX y={(x) => m * Math.abs(x - h) + v} /> and two <MovablePoint> components with appropriate aria labels and an <SRDescInSVG> description. - graphs/absolute-value.test.tsx (new file) — Unit tests covering coefficient extraction (upward/downward V, varying slopes, same-x returns undefined, left/right arm equivalence), keyboard constraint skip behaviour, and all screen reader strings (graph label, point labels, description, interactive elements text). - strings.ts — Adds five new screen reader strings (srAbsoluteValueGraph, srAbsoluteValueVertexPoint, srAbsoluteValueSecondPoint, srAbsoluteValueDescription, srAbsoluteValueInteractiveElements) with i18n context comments, English defaults, and mockStrings implementations. - mafs-graph.tsx — Replaces the PR 1 throw stub with renderAbsoluteValueGraph. - interactive-graph.tsx — Implements getAbsoluteValueEquationString (returns y = m.toFixed(3)|x - h.toFixed(3)| + v.toFixed(3)) and wires it into getEquationString. - types.ts — Exports AbsoluteValueGraphState (previously unexported), required by the new component file. Author: handeyeco Reviewers: claude[bot], handeyeco, ivyolamit, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ✅ 10 checks were successful, ⏭️ 1 check has been skipped Pull Request URL: #3350
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) -▶️ [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 --- Add scoring for absolute-value graph type Implements scoring for the absolute-value graph, isolated from rendering. Depends on PR 1 for the type definitions. Can be developed in parallel with PR 3. Changes: - kmath/src/coefficients.ts — Adds getAbsoluteValueCoefficients(coords), a canonical coefficient extractor returning [m, h, v] as an AbsoluteValueCoefficient tuple (or undefined if the two points share the same x). Lives in kmath alongside getSinusoidCoefficients and getQuadraticCoefficients for reuse by the scorer without taking a dependency on the rendering package. - kmath/src/index.ts — Exports the new AbsoluteValueCoefficient type. - data-schema.ts — Adds AbsoluteValueGraphCorrect (type: "absolute-value", coords: [Coord, Coord]) and includes it in the PerseusGraphCorrectType union, which is required for the rubric type to accept absolute-value correct answers. - score-interactive-graph.ts — Adds an else if branch for "absolute-value": extracts [m, h, v] coefficients from both the user input and rubric coords, then uses approximateDeepEqual to compare them. No canonical normalization is needed — the vertex uniquely defines position and m uniquely defines shape and orientation. - score-interactive-graph.test.ts — Six tests covering: undefined guess (invalid), missing coords (invalid), wrong slope (incorrect), correct answer, symmetry (p2 on either arm of the same V scores correctly), and downward-opening vs upward-opening mismatch (incorrect). Author: handeyeco Reviewers: claude[bot], ivyolamit, handeyeco, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ⏭️ 1 check has been skipped, ✅ 10 checks were successful Pull Request URL: #3351
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) -▶️ [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 --- Add editor support for absolute-value graph type Surfaces the absolute-value graph in the content creator UI. Depends on PR 1 + PR 2 (for getAbsoluteValueCoords). No new components needed — the two-point shape fits existing patterns. Changes: - initialize-graph-state.ts — Exports getAbsoluteValueCoords (previously file-private) so the editor can import it via @khanacademy/perseus. - perseus/src/index.ts — Re-exports getAbsoluteValueCoords alongside the other getXxxCoords helpers. - graph-type-selector.tsx — Adds <OptionItem value="absolute-value" label="Absolute value" /> to the answer type dropdown. - start-coords/types.ts — Adds {type: "absolute-value"} to GraphTypesThatHaveStartCoords so the StartCoords type includes its startCoords field. - start-coords-settings.tsx — Adds case "absolute-value" using getAbsoluteValueCoords + StartCoordsPoint (the two-point shape maps directly onto the existing generic point coordinate UI). - start-coords/util.ts — Adds case "absolute-value" in getDefaultGraphStartCoords so the "Use default start coordinates" reset button returns the correct defaults. Author: handeyeco Reviewers: claude[bot], ivyolamit, handeyeco, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ⏭️ 1 check has been skipped, ✅ 10 checks were successful Pull Request URL: #3352
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) -▶️ [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 Author: handeyeco Reviewers: claude[bot], ivyolamit, SonicScrewdriver Required Reviewers: Approved By: SonicScrewdriver Checks: ✅ 10 checks were successful, ⏭️ 1 check has been skipped Pull Request URL: #3380
This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## @khanacademy/perseus-editor@30.0.0 ### Major Changes - [#3332](#3332) [`604b3a6c25`](604b3a6) Thanks [@benchristel](https://github.com/benchristel)! - The `options` parameter of the `serialize` method of `EditorPage` and `Editor` has been removed. - [#3386](#3386) [`7e76fbbc2f`](7e76fbb) Thanks [@benchristel](https://github.com/benchristel)! - The `serialize` methods of classes in `@khanacademy/perseus-editor` no longer use arrow function syntax. Callers should not unbind them from the class instance. Additionally, the `Editor` component no longer accepts a `replace` prop (used for hints), and its serialize method no longer returns `replace`. The `replace` prop was only used in `serialize`. Users of the `Editor` component should manage hints' `replace` setting themselves. ### Minor Changes - [#3395](#3395) [`97223334ea`](9722333) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Implementation of Editor support for Exponential Graph - [#3352](#3352) [`b681e00a4f`](b681e00) Thanks [@handeyeco](https://github.com/handeyeco)! - Add editor support for AbsoluteValue - [#3348](#3348) [`b1557c2a73`](b1557c2) Thanks [@handeyeco](https://github.com/handeyeco)! - Add schema for AbsoluteValue graph - [#3345](#3345) [`dde985f3b5`](dde985f) Thanks [@ivyolamit](https://github.com/ivyolamit)! - Add tangent type definitions, this is the initial implementation for supporting Tangent graph in Interactive Graph - [#3358](#3358) [`8c503171b1`](8c50317) Thanks [@ivyolamit](https://github.com/ivyolamit)! - Add tangent graph option in the Interactive Graph Editor - [#3376](#3376) [`8aa0a77886`](8aa0a77) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Creation of new Types, Schema, and Kmath utilities for Exponential Graph ### Patch Changes - [#3396](#3396) [`35fa9133db`](35fa913) Thanks [@nishasy](https://github.com/nishasy)! - [Image] | (CX) | Add a linter warning for images with no size - [#3390](#3390) [`d22c50dc2a`](d22c50d) Thanks [@nishasy](https://github.com/nishasy)! - [Image] | (CX) | Make the 125 character alt text warning less aggressive - [#3372](#3372) [`3cdb09813d`](3cdb098) Thanks [@nishasy](https://github.com/nishasy)! - [Image] | (UX) | Upscale Graphies within Explore Image Modal - [#3391](#3391) [`2f285ee161`](2f285ee) Thanks [@nishasy](https://github.com/nishasy)! - [Image] | (CX) | Add character counter to alt text field - [#3374](#3374) [`cd73c99ba3`](cd73c99) Thanks [@ivyolamit](https://github.com/ivyolamit)! - Remove incorrect usage of the feature flag setting in one of the test - Updated dependencies \[[`f18c0d9b6f`](f18c0d9), [`a022e751d6`](a022e75), [`35fa9133db`](35fa913), [`54db3fd4bd`](54db3fd), [`97223334ea`](9722333), [`027a5edbda`](027a5ed), [`ae0538d0a7`](ae0538d), [`005e13d784`](005e13d), [`3cdb09813d`](3cdb098), [`afcff9f96f`](afcff9f), [`75f184e5a7`](75f184e), [`4b2a7c85db`](4b2a7c8), [`5e1acd01f8`](5e1acd0), [`b681e00a4f`](b681e00), [`d99f1c0259`](d99f1c0), [`54eee35d65`](54eee35), [`b1557c2a73`](b1557c2), [`dde985f3b5`](dde985f), [`56e7dbe9a2`](56e7dbe), [`85f9cd46fc`](85f9cd4), [`8c503171b1`](8c50317), [`3aca3dcdf4`](3aca3dc), [`9f29bc7161`](9f29bc7), [`7034844845`](7034844), [`8aa0a77886`](8aa0a77), [`003aca7612`](003aca7)]: - @khanacademy/perseus-linter@4.9.0 - @khanacademy/perseus-score@8.4.0 - @khanacademy/perseus-core@23.7.0 - @khanacademy/perseus@76.1.0 - @khanacademy/kmath@2.3.0 - @khanacademy/keypad-context@3.2.40 - @khanacademy/math-input@26.4.10 ## @khanacademy/kmath@2.3.0 ### Minor Changes - [#3351](#3351) [`005e13d784`](005e13d) Thanks [@handeyeco](https://github.com/handeyeco)! - Add scoring for AbsoluteValue - [#3347](#3347) [`d99f1c0259`](d99f1c0) Thanks [@ivyolamit](https://github.com/ivyolamit)! - Add the tangent math utilities to kmath for supporting Tangent graph in Interactive Graph - [#3376](#3376) [`8aa0a77886`](8aa0a77) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Creation of new Types, Schema, and Kmath utilities for Exponential Graph ### Patch Changes - Updated dependencies \[[`54db3fd4bd`](54db3fd), [`ae0538d0a7`](ae0538d), [`005e13d784`](005e13d), [`b1557c2a73`](b1557c2), [`dde985f3b5`](dde985f), [`8aa0a77886`](8aa0a77)]: - @khanacademy/perseus-core@23.7.0 ## @khanacademy/perseus@76.1.0 ### Minor Changes - [#3350](#3350) [`75f184e5a7`](75f184e) Thanks [@handeyeco](https://github.com/handeyeco)! - Implement AbsoluteValue rendering - [#3354](#3354) [`4b2a7c85db`](4b2a7c8) Thanks [@ivyolamit](https://github.com/ivyolamit)! - Created the tangent graph visual component, add Storybook coverage, SR strings, and equation string for supporting Tangent graph in Interactive Graph - [#3353](#3353) [`5e1acd01f8`](5e1acd0) Thanks [@ivyolamit](https://github.com/ivyolamit)! - Add tangent graph state management and reducer for supporting Tangent graph in Interactive Graph - [#3352](#3352) [`b681e00a4f`](b681e00) Thanks [@handeyeco](https://github.com/handeyeco)! - Add editor support for AbsoluteValue - [#3348](#3348) [`b1557c2a73`](b1557c2) Thanks [@handeyeco](https://github.com/handeyeco)! - Add schema for AbsoluteValue graph - [#3345](#3345) [`dde985f3b5`](dde985f) Thanks [@ivyolamit](https://github.com/ivyolamit)! - Add tangent type definitions, this is the initial implementation for supporting Tangent graph in Interactive Graph - [#3349](#3349) [`56e7dbe9a2`](56e7dbe) Thanks [@handeyeco](https://github.com/handeyeco)! - Add state management for AbsoluteValue - [#3377](#3377) [`85f9cd46fc`](85f9cd4) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Implementation of state management logic for new Exponential graph - [#3358](#3358) [`8c503171b1`](8c50317) Thanks [@ivyolamit](https://github.com/ivyolamit)! - Add tangent graph option in the Interactive Graph Editor - [#3393](#3393) [`9f29bc7161`](9f29bc7) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Rendering logic for new Exponential Graph - [#3376](#3376) [`8aa0a77886`](8aa0a77) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Creation of new Types, Schema, and Kmath utilities for Exponential Graph ### Patch Changes - [#3329](#3329) [`027a5edbda`](027a5ed) Thanks [@Myranae](https://github.com/Myranae)! - Fix image bug by batching setState calls in setupGraphie - [#3372](#3372) [`3cdb09813d`](3cdb098) Thanks [@nishasy](https://github.com/nishasy)! - [Image] | (UX) | Upscale Graphies within Explore Image Modal - [#3365](#3365) [`afcff9f96f`](afcff9f) Thanks [@jeremywiebe](https://github.com/jeremywiebe)! - Improve ordering of Props type for `Renderer` component - [#3367](#3367) [`54eee35d65`](54eee35) Thanks [@nishasy](https://github.com/nishasy)! - [Image] | (UX) | Show image in explore modal even when size is undefined - [#3407](#3407) [`3aca3dcdf4`](3aca3dc) Thanks [@Myranae](https://github.com/Myranae)! - Improve a11y with graded group set - [#3385](#3385) [`003aca7612`](003aca7) Thanks [@Myranae](https://github.com/Myranae)! - Small fix to prevent pip duplication in Graded Group Sets - Updated dependencies \[[`f18c0d9b6f`](f18c0d9), [`a022e751d6`](a022e75), [`35fa9133db`](35fa913), [`54db3fd4bd`](54db3fd), [`97223334ea`](9722333), [`ae0538d0a7`](ae0538d), [`005e13d784`](005e13d), [`d99f1c0259`](d99f1c0), [`b1557c2a73`](b1557c2), [`dde985f3b5`](dde985f), [`7034844845`](7034844), [`8aa0a77886`](8aa0a77)]: - @khanacademy/perseus-linter@4.9.0 - @khanacademy/perseus-score@8.4.0 - @khanacademy/perseus-core@23.7.0 - @khanacademy/kmath@2.3.0 - @khanacademy/keypad-context@3.2.40 - @khanacademy/math-input@26.4.10 ## @khanacademy/perseus-core@23.7.0 ### Minor Changes - [#3405](#3405) [`54db3fd4bd`](54db3fd) Thanks [@benchristel](https://github.com/benchristel)! - `@khanacademy/perseus-core` now exports a `removeOrphanedWidgetsFromPerseusItem` function, which removes unreferenced widgets from a `PerseusItem`'s question and hints. - [#3351](#3351) [`005e13d784`](005e13d) Thanks [@handeyeco](https://github.com/handeyeco)! - Add scoring for AbsoluteValue - [#3348](#3348) [`b1557c2a73`](b1557c2) Thanks [@handeyeco](https://github.com/handeyeco)! - Add schema for AbsoluteValue graph - [#3345](#3345) [`dde985f3b5`](dde985f) Thanks [@ivyolamit](https://github.com/ivyolamit)! - Add tangent type definitions, this is the initial implementation for supporting Tangent graph in Interactive Graph - [#3376](#3376) [`8aa0a77886`](8aa0a77) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Creation of new Types, Schema, and Kmath utilities for Exponential Graph ### Patch Changes - [#3357](#3357) [`ae0538d0a7`](ae0538d) Thanks [@jeremywiebe](https://github.com/jeremywiebe)! - Improve code documentation for all data-schema and user-input types ## @khanacademy/perseus-linter@4.9.0 ### Minor Changes - [#3381](#3381) [`f18c0d9b6f`](f18c0d9) Thanks [@anakaren-rojas](https://github.com/anakaren-rojas)! - Adds new linters for parsed objects - [#3395](#3395) [`97223334ea`](9722333) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Implementation of Editor support for Exponential Graph ### Patch Changes - [#3396](#3396) [`35fa9133db`](35fa913) Thanks [@nishasy](https://github.com/nishasy)! - [Image] | (CX) | Add a linter warning for images with no size - Updated dependencies \[[`54db3fd4bd`](54db3fd), [`ae0538d0a7`](ae0538d), [`005e13d784`](005e13d), [`d99f1c0259`](d99f1c0), [`b1557c2a73`](b1557c2), [`dde985f3b5`](dde985f), [`8aa0a77886`](8aa0a77)]: - @khanacademy/perseus-core@23.7.0 - @khanacademy/kmath@2.3.0 ## @khanacademy/perseus-score@8.4.0 ### Minor Changes - [#3356](#3356) [`a022e751d6`](a022e75) Thanks [@ivyolamit](https://github.com/ivyolamit)! - Add tangent graph scoring to support the Tangent graph in Interactive Graph - [#3351](#3351) [`005e13d784`](005e13d) Thanks [@handeyeco](https://github.com/handeyeco)! - Add scoring for AbsoluteValue - [#3394](#3394) [`7034844845`](7034844) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Implementation of new scoring logic for Exponential Graph ### Patch Changes - Updated dependencies \[[`54db3fd4bd`](54db3fd), [`ae0538d0a7`](ae0538d), [`005e13d784`](005e13d), [`d99f1c0259`](d99f1c0), [`b1557c2a73`](b1557c2), [`dde985f3b5`](dde985f), [`8aa0a77886`](8aa0a77)]: - @khanacademy/perseus-core@23.7.0 - @khanacademy/kmath@2.3.0 ## @khanacademy/keypad-context@3.2.40 ### Patch Changes - Updated dependencies \[[`54db3fd4bd`](54db3fd), [`ae0538d0a7`](ae0538d), [`005e13d784`](005e13d), [`b1557c2a73`](b1557c2), [`dde985f3b5`](dde985f), [`8aa0a77886`](8aa0a77)]: - @khanacademy/perseus-core@23.7.0 ## @khanacademy/math-input@26.4.10 ### Patch Changes - Updated dependencies \[[`54db3fd4bd`](54db3fd), [`ae0538d0a7`](ae0538d), [`005e13d784`](005e13d), [`b1557c2a73`](b1557c2), [`dde985f3b5`](dde985f), [`8aa0a77886`](8aa0a77)]: - @khanacademy/perseus-core@23.7.0 - @khanacademy/keypad-context@3.2.40
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: -▶️ [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 Author: handeyeco Reviewers: claude[bot], handeyeco, ivyolamit, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ⏭️ 1 check has been skipped, ✅ 10 checks were successful Pull Request URL: #3346
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) -▶️ [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 --- Add type definitions and schema for absolute-value graph type Adds the foundational type scaffolding needed to support an absolute-value graph in the Interactive Graph widget. This is a pure additive change — no runtime behavior is altered and all existing tests continue to pass. Changes: - data-schema.ts — Adds PerseusGraphTypeAbsoluteValue (type: "absolute-value", coords, startCoords) and includes it in the PerseusGraphType union. - interactive-graph-widget.ts — Registers parsePerseusGraphTypeAbsoluteValue with parsePerseusGraphType so the new type round-trips through the parser. - types.ts — Adds AbsoluteValueGraphState (mirrors SinusoidGraphState: vertex + arm point) and adds it to the InteractiveGraphState union. - interactive-graph-ai-utils.ts — Adds AbsoluteValueGraphOptions and AbsoluteValueUserInput types and wires them into getGraphOptionsForProps / getUserInput to satisfy exhaustiveness checks. - Stubs out "absolute-value" cases with throw new Error("Not implemented") in initializeGraphState, mafsStateToInteractiveGraph, renderGraphElements, and getEquationString to keep TypeScript exhaustiveness errors clear until subsequent PRs fill in the implementation. - Adds "absolute-value" to the mergeGraphs switch and shouldShowStartCoordsUI in the editor to satisfy exhaustiveness checks there as well. Author: handeyeco Reviewers: claude[bot], handeyeco, ivyolamit, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ✅ 10 checks were successful, ⏭️ 1 check has been skipped Pull Request URL: #3348
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) -▶️ [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 --- Implements the full state pipeline for the absolute-value graph: initialization, reducer transitions, serialization, and test infrastructure. Depends on PR 1. No rendering yet — the renderGraphElements stub from PR 1 remains in place. Changes: - initialize-graph-state.ts — Replaces the PR 1 stub with a real initializeGraphState case. Adds getAbsoluteValueCoords(graph, range, step): returns graph.coords if set, then graph.startCoords, then normalized defaults [[0.5, 0.5], [0.75, 0.75]] (same pattern as sinusoid/quadratic). Note: currently unexported — PR 5 exports it for editor use. - interactive-graph-action.ts — Adds actions.absoluteValue.movePoint by reusing the shared movePoint action factory (same approach as sinusoid). - interactive-graph-reducer.ts — Adds a case "absolute-value" in doMovePoint that snaps/bounds the destination, then rejects the move if the two points would share the same x-coordinate (slope would be undefined). - interactive-graph-state.ts — Adds a branch in getGradableGraph() that serializes AbsoluteValueGraphState back to PerseusGraphTypeAbsoluteValue for scoring. - mafs-state-to-interactive-graph.ts — Replaces the PR 1 stub with a real case that maps state coords back to the graph type for live interaction (e.g. equation display). - interactive-graph-question-builder.ts — Adds withAbsoluteValue(options?) builder method and AbsoluteValueGraphConfig class so test fixtures can construct absolute-value questions. Author: handeyeco Reviewers: claude[bot], ivyolamit, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ⏭️ 1 check has been skipped, ✅ 10 checks were successful Pull Request URL: #3349
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) -▶️ [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 --- Implement rendering and accessibility for absolute-value graph type Adds the visual component, screen reader strings, equation display, and unit tests for the absolute-value graph. Depends on PR 1 + PR 2. After this PR the graph is fully interactive and renderable. Changes: - graphs/absolute-value.tsx (new file) — Implements renderAbsoluteValueGraph, the AbsoluteValueGraph component, and two exported helpers: - getAbsoluteValueCoefficients(coords) — extracts {m, h, v} from the two control points, returning undefined if both share the same x. Uses a coeffRef to cache the last valid result for transient mid-drag states. - getAbsoluteValueKeyboardConstraint(coords, snapStep, pointIndex) — keyboard movement constraint that skips any position where the moved point would share an x-coordinate with the other point. - Renders a single <Plot.OfX y={(x) => m * Math.abs(x - h) + v} /> and two <MovablePoint> components with appropriate aria labels and an <SRDescInSVG> description. - graphs/absolute-value.test.tsx (new file) — Unit tests covering coefficient extraction (upward/downward V, varying slopes, same-x returns undefined, left/right arm equivalence), keyboard constraint skip behaviour, and all screen reader strings (graph label, point labels, description, interactive elements text). - strings.ts — Adds five new screen reader strings (srAbsoluteValueGraph, srAbsoluteValueVertexPoint, srAbsoluteValueSecondPoint, srAbsoluteValueDescription, srAbsoluteValueInteractiveElements) with i18n context comments, English defaults, and mockStrings implementations. - mafs-graph.tsx — Replaces the PR 1 throw stub with renderAbsoluteValueGraph. - interactive-graph.tsx — Implements getAbsoluteValueEquationString (returns y = m.toFixed(3)|x - h.toFixed(3)| + v.toFixed(3)) and wires it into getEquationString. - types.ts — Exports AbsoluteValueGraphState (previously unexported), required by the new component file. Author: handeyeco Reviewers: claude[bot], handeyeco, ivyolamit, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ✅ 10 checks were successful, ⏭️ 1 check has been skipped Pull Request URL: #3350
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) -▶️ [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 --- Add scoring for absolute-value graph type Implements scoring for the absolute-value graph, isolated from rendering. Depends on PR 1 for the type definitions. Can be developed in parallel with PR 3. Changes: - kmath/src/coefficients.ts — Adds getAbsoluteValueCoefficients(coords), a canonical coefficient extractor returning [m, h, v] as an AbsoluteValueCoefficient tuple (or undefined if the two points share the same x). Lives in kmath alongside getSinusoidCoefficients and getQuadraticCoefficients for reuse by the scorer without taking a dependency on the rendering package. - kmath/src/index.ts — Exports the new AbsoluteValueCoefficient type. - data-schema.ts — Adds AbsoluteValueGraphCorrect (type: "absolute-value", coords: [Coord, Coord]) and includes it in the PerseusGraphCorrectType union, which is required for the rubric type to accept absolute-value correct answers. - score-interactive-graph.ts — Adds an else if branch for "absolute-value": extracts [m, h, v] coefficients from both the user input and rubric coords, then uses approximateDeepEqual to compare them. No canonical normalization is needed — the vertex uniquely defines position and m uniquely defines shape and orientation. - score-interactive-graph.test.ts — Six tests covering: undefined guess (invalid), missing coords (invalid), wrong slope (incorrect), correct answer, symmetry (p2 on either arm of the same V scores correctly), and downward-opening vs upward-opening mismatch (incorrect). Author: handeyeco Reviewers: claude[bot], ivyolamit, handeyeco, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ⏭️ 1 check has been skipped, ✅ 10 checks were successful Pull Request URL: #3351
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) -▶️ [Perseus#3352: PR5 - editor support](#3352) - [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 --- Add editor support for absolute-value graph type Surfaces the absolute-value graph in the content creator UI. Depends on PR 1 + PR 2 (for getAbsoluteValueCoords). No new components needed — the two-point shape fits existing patterns. Changes: - initialize-graph-state.ts — Exports getAbsoluteValueCoords (previously file-private) so the editor can import it via @khanacademy/perseus. - perseus/src/index.ts — Re-exports getAbsoluteValueCoords alongside the other getXxxCoords helpers. - graph-type-selector.tsx — Adds <OptionItem value="absolute-value" label="Absolute value" /> to the answer type dropdown. - start-coords/types.ts — Adds {type: "absolute-value"} to GraphTypesThatHaveStartCoords so the StartCoords type includes its startCoords field. - start-coords-settings.tsx — Adds case "absolute-value" using getAbsoluteValueCoords + StartCoordsPoint (the two-point shape maps directly onto the existing generic point coordinate UI). - start-coords/util.ts — Adds case "absolute-value" in getDefaultGraphStartCoords so the "Use default start coordinates" reset button returns the correct defaults. Author: handeyeco Reviewers: claude[bot], ivyolamit, handeyeco, SonicScrewdriver Required Reviewers: Approved By: ivyolamit Checks: ⏭️ 1 check has been skipped, ✅ 10 checks were successful Pull Request URL: #3352
Everything is AI ## Summary: This is part of a series of PRs as defined in the first PR: - [Perseus#3346: PR implementation guide](#3346) - [Perseus#3348: PR1 - type definitions and schema](#3348) - [Perseus#3349: PR2 - state management](#3349) - [Perseus#3350: PR3 - rendering & accessibility](#3350) - [Perseus#3351: PR4 - scoring](#3351) - [Perseus#3352: PR5 - editor support](#3352) -▶️ [Perseus#3380: Convert todo into a long-term doc](#3380) Initial implementation experiment is [Perseus#3304](#3304). Issue: LEMS-3347 Author: handeyeco Reviewers: claude[bot], ivyolamit, SonicScrewdriver Required Reviewers: Approved By: SonicScrewdriver Checks: ✅ 10 checks were successful, ⏭️ 1 check has been skipped Pull Request URL: #3380
Everything is AI
Summary:
This is part of a series of PRs as defined in the first PR:
Initial implementation experiment is Perseus#3304.
Issue: LEMS-3347
Implements the full state pipeline for the absolute-value graph:
initialization, reducer transitions, serialization, and test
infrastructure. Depends on PR 1. No rendering yet — the renderGraphElements
stub from PR 1 remains in place.
Changes:
initializeGraphState case. Adds getAbsoluteValueCoords(graph, range, step):
returns graph.coords if set, then graph.startCoords, then normalized
defaults [[0.5, 0.5], [0.75, 0.75]] (same pattern as sinusoid/quadratic).
Note: currently unexported — PR 5 exports it for editor use.
reusing the shared movePoint action factory (same approach as sinusoid).
doMovePoint that snaps/bounds the destination, then rejects the move if the
two points would share the same x-coordinate (slope would be undefined).
serializes AbsoluteValueGraphState back to PerseusGraphTypeAbsoluteValue
for scoring.
case that maps state coords back to the graph type for live interaction
(e.g. equation display).
builder method and AbsoluteValueGraphConfig class so test fixtures can
construct absolute-value questions.