Integrate TeX Debugging Info into Issues Panel #3097

Myranae · 2025-12-08T16:23:30Z

Summary:

Problem

TeX rendering errors were previously displayed in a separate TexErrorView component below the editor, making them easy to overlook and inconsistent with how other content issues are surfaced. This separation meant content creators might miss important TeX syntax problems until later in the authoring process.

Solution

Integrated TeX debugging information into the unified Issues Panel alongside linter warnings and accessibility issues. Created a detectTexErrors() utility that parses content and validates math expressions with KaTeX, then transforms any errors into the standard Issue format. TeX debugging info now appears prominently in the Issues Panel with helpful descriptions and links to documentation, giving content creators a single location to review all content quality concerns.

-> Summary and code changes done with Claude Code <-

Issue: LEMS-3046

Test plan:

Confirm all checks pass
Manually confirm TeX debugging info appears with incorrect TeX
Possibly request content authors test out a ZND to confirm multiple types of potential TeX errors are caught

… panel

…make-tex-bar-pop

… to Issues panel

github-actions · 2025-12-08T16:25:39Z

npm Snapshot: Published

Good news!! We've packaged up the latest commit from this PR (ff2316a) and published it to npm. You
can install it using the tag PR3097.

Example:

pnpm add @khanacademy/perseus@PR3097

If you are working in Khan Academy's frontend, you can run the below command.

./dev/tools/bump_perseus_version.ts -t PR3097

If you are working in Khan Academy's webapp, you can run the below command.

./dev/tools/bump_perseus_version.js -t PR3097

github-actions · 2025-12-08T16:25:55Z

🗄️ Schema Change: No Changes ✅

github-actions · 2025-12-08T16:26:27Z

🛠️ Item Splitting: No Changes ✅

github-actions · 2025-12-08T16:26:32Z

Size Change: -277 B (-0.06%)

Total Size: 498 kB

Filename	Size	Change
`packages/perseus-editor/dist/es/index.js`	97.9 kB	-277 B (-0.28%)

ℹ️ View Unchanged

Filename	Size
`packages/kas/dist/es/index.js`	20.8 kB
`packages/keypad-context/dist/es/index.js`	1 kB
`packages/kmath/dist/es/index.js`	5.98 kB
`packages/math-input/dist/es/index.js`	99.2 kB
`packages/math-input/dist/es/strings.js`	1.61 kB
`packages/perseus-core/dist/es/index.item-splitting.js`	13.1 kB
`packages/perseus-core/dist/es/index.js`	24.7 kB
`packages/perseus-linter/dist/es/index.js`	8.64 kB
`packages/perseus-score/dist/es/index.js`	9.2 kB
`packages/perseus-utils/dist/es/index.js`	403 B
`packages/perseus/dist/es/index.js`	200 kB
`packages/perseus/dist/es/strings.js`	7.73 kB
`packages/pure-markdown/dist/es/index.js`	1.39 kB
`packages/simple-markdown/dist/es/index.js`	6.72 kB

_{compressed-size-action}

jeremywiebe

This is great! I left a non-blocking comment about using MathJax for this instead of KaTeX.

jeremywiebe · 2025-12-08T17:59:47Z

packages/perseus-editor/src/util/tex-error-detector.ts

@@ -0,0 +1,46 @@
+import {preprocessTex, PerseusMarkdown} from "@khanacademy/perseus";
+import katex from "katex";


Does MathJax provide any features that we could use instead? If I remember correctly, this is the last vestige of KaTeX at Khan Academy. Continuing to use it means that we could be flagging issues that MathJax doesn't have a problem with and/or vice-versa.

I think we kept it here because KaTeX will find more issues than MathJax will (and we wanted that for a specific reason), and I thought there was still content that used KaTeX, or that content authors still used KaTeX, something like that. I should have tried to get this out before Ben became a pumpkin, but oh well 😅 I'll create a ticket to review the use of KaTeX here and check in with Ben about just switching this to MathJax since I don't remember the relevant context. Does that sound okay for now?

Absolutely. We can come back to this in the new year!

packages/perseus-editor/src/util/tex-error-detector.ts

packages/perseus-editor/src/messages.ts

packages/perseus-editor/src/util/tex-error-detector.test.ts

…make-tex-bar-pop

@SonicScrewdriver

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/[email protected] ### Minor Changes - [#3091](#3091) [`27ab0dba64`](27ab0db) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Move the Khanmigo data functions to Perseus Core for Server Side Scoring initiative ### Patch Changes - [#3086](#3086) [`0d1d39b563`](0d1d39b) Thanks [@nishasy](https://github.com/nishasy)! - Create free response widget generator for testdata - [#3098](#3098) [`7df7755d56`](7df7755) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Sync dependencies - Updated dependencies \[[`27ab0dba64`](27ab0db), [`0d1d39b563`](0d1d39b), [`7df7755d56`](7df7755)]: - @khanacademy/[email protected] - @khanacademy/[email protected] - @khanacademy/[email protected] - @khanacademy/[email protected] - @khanacademy/[email protected] - @khanacademy/[email protected] ## @khanacademy/[email protected] ### Minor Changes - [#3091](#3091) [`27ab0dba64`](27ab0db) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Move the Khanmigo data functions to Perseus Core for Server Side Scoring initiative ### Patch Changes - [#3086](#3086) [`0d1d39b563`](0d1d39b) Thanks [@nishasy](https://github.com/nishasy)! - Create free response widget generator for testdata ## @khanacademy/[email protected] ### Patch Changes - Updated dependencies \[[`27ab0dba64`](27ab0db), [`0d1d39b563`](0d1d39b)]: - @khanacademy/[email protected] ## @khanacademy/[email protected] ### Patch Changes - Updated dependencies \[[`27ab0dba64`](27ab0db), [`0d1d39b563`](0d1d39b)]: - @khanacademy/[email protected] ## @khanacademy/[email protected] ### Patch Changes - [#3098](#3098) [`7df7755d56`](7df7755) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Sync dependencies - Updated dependencies \[[`27ab0dba64`](27ab0db), [`0d1d39b563`](0d1d39b)]: - @khanacademy/[email protected] - @khanacademy/[email protected] ## @khanacademy/[email protected] ### Patch Changes - [#3083](#3083) [`9b4aa293ac`](9b4aa29) Thanks [@jeremywiebe](https://github.com/jeremywiebe)! - Improve TypeScript (message) types used for previewing - [#3086](#3086) [`0d1d39b563`](0d1d39b) Thanks [@nishasy](https://github.com/nishasy)! - Create free response widget generator for testdata - [#3098](#3098) [`7df7755d56`](7df7755) Thanks [@SonicScrewdriver](https://github.com/SonicScrewdriver)! - Sync dependencies - [#3097](#3097) [`f0cceb96ff`](f0cceb9) Thanks [@Myranae](https://github.com/Myranae)! - Move TeX issues info to Issues panel - Updated dependencies \[[`27ab0dba64`](27ab0db), [`0d1d39b563`](0d1d39b), [`7df7755d56`](7df7755)]: - @khanacademy/[email protected] - @khanacademy/[email protected] - @khanacademy/[email protected] - @khanacademy/[email protected] - @khanacademy/[email protected] - @khanacademy/[email protected] - @khanacademy/[email protected] ## @khanacademy/[email protected] ### Patch Changes - Updated dependencies \[[`27ab0dba64`](27ab0db), [`0d1d39b563`](0d1d39b)]: - @khanacademy/[email protected] - @khanacademy/[email protected] ## @khanacademy/[email protected] ### Patch Changes - Updated dependencies \[[`27ab0dba64`](27ab0db), [`0d1d39b563`](0d1d39b)]: - @khanacademy/[email protected] - @khanacademy/[email protected]

Myranae added 4 commits December 8, 2025 09:24

[tb/LEMS-3046/make-tex-bar-pop] First draft moving tex info to issues…

f674de7

… panel

[tb/LEMS-3046/make-tex-bar-pop] Update id and description

949ff34

[tb/LEMS-3046/make-tex-bar-pop] Merge branch 'main' into tb/LEMS-3046/…

542b344

…make-tex-bar-pop

[tb/LEMS-3046/make-tex-bar-pop] docs(changeset): Move TeX issues info…

6d36714

… to Issues panel

Myranae self-assigned this Dec 8, 2025

Myranae added the olc-5.0.b6bfb label Dec 8, 2025

github-actions bot added schema-change Attached to PRs when we detect Perseus Schema changes in it item-splitting-change labels Dec 8, 2025

github-actions bot removed the schema-change Attached to PRs when we detect Perseus Schema changes in it label Dec 8, 2025

github-actions bot removed the item-splitting-change label Dec 8, 2025

[tb/LEMS-3046/make-tex-bar-pop] Small updates after review

b0b6898

Myranae marked this pull request as ready for review December 8, 2025 17:34

Myranae added the project agnostic PRs reviewable by any Perseus team member label Dec 8, 2025

Myranae requested review from a team, catandthemachines and mark-fitzgerald December 8, 2025 17:34

github-actions bot added schema-change Attached to PRs when we detect Perseus Schema changes in it item-splitting-change and removed schema-change Attached to PRs when we detect Perseus Schema changes in it item-splitting-change labels Dec 8, 2025

jeremywiebe approved these changes Dec 8, 2025

View reviewed changes

mark-fitzgerald reviewed Dec 8, 2025

View reviewed changes

packages/perseus-editor/src/messages.ts Show resolved Hide resolved

mark-fitzgerald reviewed Dec 8, 2025

View reviewed changes

packages/perseus-editor/src/util/tex-error-detector.test.ts Show resolved Hide resolved

mark-fitzgerald approved these changes Dec 8, 2025

View reviewed changes

Myranae added 2 commits December 8, 2025 13:12

[tb/LEMS-3046/make-tex-bar-pop] Remove ts expect error

aa885fb

[tb/LEMS-3046/make-tex-bar-pop] Merge branch 'main' into tb/LEMS-3046/…

ff2316a

…make-tex-bar-pop

Myranae merged commit f0cceb9 into main Dec 8, 2025
11 checks passed

Myranae deleted the tb/LEMS-3046/make-tex-bar-pop branch December 8, 2025 19:30

khan-actions-bot mentioned this pull request Dec 8, 2025

Version Packages #3090

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Integrate TeX Debugging Info into Issues Panel #3097

Integrate TeX Debugging Info into Issues Panel #3097

Uh oh!

Myranae commented Dec 8, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Dec 8, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Dec 8, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Dec 8, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Dec 8, 2025 •

edited

Loading

Uh oh!

jeremywiebe left a comment

Uh oh!

jeremywiebe Dec 8, 2025

Uh oh!

Myranae Dec 8, 2025

Uh oh!

jeremywiebe Dec 9, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

		@@ -0,0 +1,46 @@
		import {preprocessTex, PerseusMarkdown} from "@khanacademy/perseus";
		import katex from "katex";

Integrate TeX Debugging Info into Issues Panel #3097

Integrate TeX Debugging Info into Issues Panel #3097

Uh oh!

Conversation

Myranae commented Dec 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary:

Problem

Solution

Test plan:

Uh oh!

github-actions bot commented Dec 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

npm Snapshot: Published

Uh oh!

github-actions bot commented Dec 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🗄️ Schema Change: No Changes ✅

Uh oh!

github-actions bot commented Dec 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🛠️ Item Splitting: No Changes ✅

Uh oh!

github-actions bot commented Dec 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jeremywiebe left a comment

Choose a reason for hiding this comment

Uh oh!

jeremywiebe Dec 8, 2025

Choose a reason for hiding this comment

Uh oh!

Myranae Dec 8, 2025

Choose a reason for hiding this comment

Uh oh!

jeremywiebe Dec 9, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Myranae commented Dec 8, 2025 •

edited

Loading

github-actions bot commented Dec 8, 2025 •

edited

Loading

github-actions bot commented Dec 8, 2025 •

edited

Loading

github-actions bot commented Dec 8, 2025 •

edited

Loading

github-actions bot commented Dec 8, 2025 •

edited

Loading