Skip to content

fix: contain oversized Markdown math accessibly - #277

Merged
olliethedev merged 4 commits into
mainfrom
fix/markdown-math-overflow
Sep 16, 2026
Merged

olliethedev merged 4 commits into
mainfrom
fix/markdown-math-overflow

Conversation

@olliethedev

@olliethedev olliethedev commented Sep 16, 2026

Copy link
Copy Markdown
Collaborator

Long inline or display KaTeX expressions can push the whole article beyond a narrow viewport. Keep each expression inside a horizontally scrollable region with keyboard focus and a visible focus indicator, preserving the MathML and surrounding prose. Apply the styles to both standalone Markdown and the blog plugin, and regenerate the affected registry output.

Fixes the shared cause of olliethedev/bio-mogging#139. The application update and production verification follow the stable patch release.

The regression test creates a real blog post containing ordinary inline math, oversized inline/display math, and a table. Before the fix it reproduces 231px of document overflow at 320px. With the fix it verifies 320/390/1280px layout, retained MathML, and keyboard access to the full expression. Local build, lint, typecheck, and unit tests pass; all 19 local blog smoke tests pass, including post navigation and fixture cleanup. CI also exercises the generated consumers and registry.

Bump @btst/stack and @btst/codegen to 3.1.1 for the existing paired release workflow's exact-source requirement. No dependencies or release-gate rules change. Publication requires completed final-head review, all CI and real deployments green, and the same checks on the merge commit.

@vercel

vercel Bot commented Sep 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
better-stack-docs Ready Ready Preview Sep 16, 2026 8:56pm UTC
better-stack-playground Ready Ready Preview Sep 16, 2026 8:56pm UTC

Request Review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 16, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-16T20:59:44.363436Z 72d0b80 Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9c81a11a5f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread packages/cli/package.json Outdated
@olliethedev

Copy link
Copy Markdown
Collaborator Author

@codex review — final head 69b069e incorporates main after the 3.1.0 release and prepares the compatible 3.1.1 patch. Local build, typecheck and lint pass after resolving the version conflicts.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 69b069eba9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread packages/cli/package.json
@olliethedev

Copy link
Copy Markdown
Collaborator Author

@codex review — the final head fixes both scaffold-pin findings. Please review the current commit.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Delightful!

Reviewed commit: 76b346b238

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@olliethedev

Copy link
Copy Markdown
Collaborator Author

@codex review — final head 72d0b8026011cc117de4e8c3e90fb8f65d5d9c10 cleans up the new published math fixture in finally. The previous CI run passed the math layout assertions but correctly caught the leftover fixture changing the existing post-navigation expectation. The fixture now deletes its own post through the authenticated test API, including when an assertion fails. CI is running again; local full blog smoke verification is underway.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Nice work!

Reviewed commit: 72d0b80260

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@olliethedev
olliethedev merged commit 77c2151 into main Sep 16, 2026
14 checks passed

This branch was successfully deployed

2 active deployments
Preview – better-stack-docs 72d0b802 Deployed Sep 16, 2026 by vercel[bot]
Preview – better-stack-playground 72d0b802 Deployed Sep 16, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant