Skip to content

fix: wait for runtime output before completing guide checkpoints - #1437

Open
fhammerschmidt wants to merge 2 commits into
rescript-lang:masterfrom
fhammerschmidt:fix/1421-guide-checkpoint
Open

fhammerschmidt wants to merge 2 commits into
rescript-lang:masterfrom
fhammerschmidt:fix/1421-guide-checkpoint

Conversation

@fhammerschmidt

@fhammerschmidt fhammerschmidt commented Oct 9, 2026 •

Copy link
Copy Markdown
Member

Lesson 1 prefilled the output with hello, world!, so a fresh visit completed and saved the checkpoint before the compiler loaded. Tests that rendered no compiler also relied on this output.

Start every lesson with empty output and remove the first-lesson special case when navigating. The checkpoint now waits for matching runtime output; saved progress still enables navigation on later visits.

Add browser regressions for a missing or loading compiler, failed compiler loading, compilation failure, matching iframe output and saved progress, and nonmatching output. Compiler responses are controlled at the CDN boundary; the compiler manager, bridge, runtime transform, and iframe run normally. Navigation tests arrange saved progress explicitly, clear browser storage between tests, and use MemoryRouter for history navigation.

Targets website master (v12). No compiler repository changes.

Validation:

  • All six GitHub Actions jobs pass, including 55 guide tests, 131 docs browser tests, and 56 docs script tests.
  • Local ReScript compilation with warnings treated as errors and the guide production build pass.
  • Verified the prerendered guide starts with a pending checkpoint, disabled Next button, and empty output.
  • Local checks pass for all 188 documentation pages, links, and redirects.
  • Formatting passes.

Fixes #1403.
Part of #1421.

Start every lesson with empty output instead of pre-completing the first checkpoint. Cover compiler loading and failure, iframe output, saved progress, and nonmatching output. Arrange navigation tests with explicit progress and isolate their storage.

Fixes rescript-lang#1403

Part of rescript-lang#1421.
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 9, 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-10-09T20:52:26.710257Z 0a48441 PR opened
ℹ️ 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.

Match the API v8 configuration shape and setters used during compiler setup so checkpoint regressions reach compilation and iframe execution.

This branch has not been deployed

No deployments
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.

Lesson 1's checkpoint passes before anything compiles

1 participant