docs: explain self-referencing callbacks

[czabaj]

Document how a callback can use a function returned by its registration call through a ref. Use a small subscription example in the v12 mutation guide and explain that the callback must run after registration returns.

Original discussion.

[vercel]

@czabaj is attempting to deploy a commit to the ReScript Association Team on Vercel.

A member of the Team first needs to authorize it.

[fhammerschmidt]

Sorry I missed this during my christmas break.

The example seems pretty heavy and we usually try to avoid React-specific code in the main documentation. Can you come up with a simpler example that doesn't need React?

[jderochervlk]

@codex can you come up with a different example?

[chatgpt-codex-connector]

Summary

• Replaced the React-specific dialog example with a smaller, framework-independent listener example that stops itself after receiving its first message. pages/docs/manual/v11.0.0/mutation.mdxL77-L93
• Updated the accompanying JavaScript output to match the new self-referencing ref example. pages/docs/manual/v11.0.0/mutation.mdxL95-L104
• Committed the changes as 007a274 (docs: simplify self-referencing ref example) and created PR metadata titled “docs: replace React self-reference example with a listener.”

Testing

• ✅ git diff --check
• ✅ node_modules/@rescript/linux-x64/bin/bsc.exe /tmp/self-reference.res -uncurried -o /tmp/self-reference.js
• ⚠️ npm test (environment’s installed glob package does not provide the default export expected by the test script under Node.js 24)
• ⚠️ npm install in compilers/ (the package registry returned HTTP 403 for scheduler-0.23.0.tgz, preventing installation of the pinned ReScript 11 test toolchain)

View task →