René's URL Explorer Experiment


Title: docs: Notes for the laziness runtime contract (#44) by Unisay · Pull Request #127 · purescript-lua/purescript-lua · GitHub

Open Graph Title: docs: Notes for the laziness runtime contract (#44) by Unisay · Pull Request #127 · purescript-lua/purescript-lua

X Title: docs: Notes for the laziness runtime contract (#44) by Unisay · Pull Request #127 · purescript-lua/purescript-lua

Description: Summary Continues #44, the laziness batch. The runtime-lazy path is the part of the compiler most exposed to silent breakage (the bug fixed in #126 lived here and went unnoticed because nothing documented or tested the contract). This batch documents that contract and corrects two stale comments. Comments only, so generated code, goldens, and eval oracles are unchanged. Note [The runtimeLazy calling convention] in Backend.Lua.Fixture. The fixture side had no comment at all. The Note spells out the curried PSLUA_runtime_lazy(name)(init)(line) shape, and in particular why state and val must live in the function(init) closure rather than the forcing thunk (declaring them in the thunk is exactly what broke memoization in #126). It also points back at the two transform sites that must keep the arity in step. Note [Laziness transform for recursive binding groups] in CoreFn.Laziness. The module had a thorough overview comment but no titled anchor, so nothing could cite the transform by name. This adds a short anchor that points at the existing prose. Corrected two comments inherited from the upstream JS backend that no longer match this port: the factory is applied to two arguments here (identifier, thunk), not three (the JS backend also threads the module name), and the Lua fixture ignores the line number passed to a force call (the JS backend uses it in the loop error message). A note on scope CoreFn.Laziness is adapted from the upstream purs compiler, and the issue asks to weigh divergence before retitling its comments. The delay/force and USE-INIT/USE-USE/USE-IMMEDIATE rules there are already documented thoroughly and are only cited from within the file, so I deliberately left that prose untouched rather than wrap it in Note blocks for marginal intra-file benefit. The cross-module contract (the runtime-lazy convention) is where the citable Note earns its keep, and the fixture half of it is our own code. Checklist Added a changelog.d/ fragment for any user-facing change (scriv create in the dev shell), or this change ships nothing releasable (CI, docs, or an internal refactor). In the dev shell (nix develop), fourmolu -i lib/ exe/ test/ and hlint lib/ exe/ test/ are clean. In the dev shell, cabal test all passes; structural goldens were re-accepted on purpose if codegen moved (PSLUA_GOLDEN_ACCEPT=1), and eval/golden.txt still holds.

Open Graph Description: Summary Continues #44, the laziness batch. The runtime-lazy path is the part of the compiler most exposed to silent breakage (the bug fixed in #126 lived here and went unnoticed because nothing doc...

X Description: Summary Continues #44, the laziness batch. The runtime-lazy path is the part of the compiler most exposed to silent breakage (the bug fixed in #126 lived here and went unnoticed because nothing doc...

Opengraph URL: https://github.com/purescript-lua/purescript-lua/pull/127

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:cc7f179d-ade9-fa7c-3a73-c0ace9118367
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-id86A8:21BD98:15FF7E:1BBCD5:6B00F9D9
html-safe-nonce3f062301504a86ffa3141f97d6d5c853127070d2d2e0a9c0a561c9cdc84e6217
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4NkE4OjIxQkQ5ODoxNUZGN0U6MUJCQ0Q1OjZCMDBGOUQ5IiwidmlzaXRvcl9pZCI6IjQzMTc5NjAyNTQ4OTA1MDY3MTMiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac1edaa7c17ed979cb0b7d860eebaac3403d71fb1047710570c8789183bd328159
hovercard-subject-tagpull_request:3937064310
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/purescript-lua/purescript-lua/pull/127/files
twitter:imagehttps://avatars.githubusercontent.com/u/1009751?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/1009751?s=400&v=4
og:image:altSummary Continues #44, the laziness batch. The runtime-lazy path is the part of the compiler most exposed to silent breakage (the bug fixed in #126 lived here and went unnoticed because nothing doc...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
Nonee208d86428ec00a57ade75058166297440e8128a01e5287c31a53dc042bbf187
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/purescript-lua/purescript-lua git https://github.com/purescript-lua/purescript-lua.git
octolytics-dimension-user_id131581790
octolytics-dimension-user_loginpurescript-lua
octolytics-dimension-repository_id587200487
octolytics-dimension-repository_nwopurescript-lua/purescript-lua
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id587200487
octolytics-dimension-repository_network_root_nwopurescript-lua/purescript-lua
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release7dafd017fb7809a839c443dba08622af38e63c09
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/purescript-lua/purescript-lua/pull/127/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpurescript-lua%2Fpurescript-lua%2Fpull%2F127%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpurescript-lua%2Fpurescript-lua%2Fpull%2F127%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=purescript-lua%2Fpurescript-lua
Reloadhttps://github.com/purescript-lua/purescript-lua/pull/127/files
Reloadhttps://github.com/purescript-lua/purescript-lua/pull/127/files
Reloadhttps://github.com/purescript-lua/purescript-lua/pull/127/files
purescript-luahttps://github.com/purescript-lua
purescript-luahttps://github.com/purescript-lua/purescript-lua
Codehttps://github.com/purescript-lua/purescript-lua
Issues48 (48)https://github.com/purescript-lua/purescript-lua/issues
Pull requestshttps://github.com/purescript-lua/purescript-lua/pulls
Discussionshttps://github.com/purescript-lua/purescript-lua/discussions
Actionshttps://github.com/purescript-lua/purescript-lua/actions
Projectshttps://github.com/purescript-lua/purescript-lua/projects
Security and qualityhttps://github.com/purescript-lua/purescript-lua/security
Insightshttps://github.com/purescript-lua/purescript-lua/insights
Sign up for GitHub https://github.com/signup?return_to=%2Fpurescript-lua%2Fpurescript-lua%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fpurescript-lua%2Fpurescript-lua%2Fissues%2Fnew%2Fchoose
Unisayhttps://github.com/Unisay
mainhttps://github.com/purescript-lua/purescript-lua/tree/main
issue-44/notes-lazinesshttps://github.com/purescript-lua/purescript-lua/tree/issue-44/notes-laziness
Conversation 5 https://github.com/purescript-lua/purescript-lua/pull/127
Commits 2 https://github.com/purescript-lua/purescript-lua/pull/127/commits
Checks 2 https://github.com/purescript-lua/purescript-lua/pull/127/checks
Files changed https://github.com/purescript-lua/purescript-lua/pull/127/files
Please reload this pagehttps://github.com/purescript-lua/purescript-lua/pull/127/files
docs: Notes for the laziness runtime contract (#44) https://github.com/purescript-lua/purescript-lua/pull/127/files#top
Show all changes 2 commits https://github.com/purescript-lua/purescript-lua/pull/127/files
dc9b8f1 docs: Notes for the laziness runtime contract (#44) Unisay Jun 25, 2026 https://github.com/purescript-lua/purescript-lua/pull/127/commits/dc9b8f1c76e3860327ab91bbfa984d6bd1393487
811e3c5 docs: address Copilot review on #127 (force-call argument is hardcode… Unisay Jun 25, 2026 https://github.com/purescript-lua/purescript-lua/pull/127/commits/811e3c54b4d4c5e16a8e18377791f08f62c82d65
Clear filters https://github.com/purescript-lua/purescript-lua/pull/127/files
Please reload this pagehttps://github.com/purescript-lua/purescript-lua/pull/127/files
Please reload this pagehttps://github.com/purescript-lua/purescript-lua/pull/127/files
20260625_191608_unisay_notes_laziness.md https://github.com/purescript-lua/purescript-lua/pull/127/files#diff-40525969b74ba582dabbc68025ddc52d26ea37f2b66bdedcde028db7ae043792
Fixture.hs https://github.com/purescript-lua/purescript-lua/pull/127/files#diff-dfc024b7df4b318856630a367ba4df5944cca498cd9ce3a4135650d777d8839c
Laziness.hs https://github.com/purescript-lua/purescript-lua/pull/127/files#diff-5821eabd1e62dc7d2d0926d105e120b5d5e9d59de759a81c639cd1bd11826525
changelog.d/20260625_191608_unisay_notes_laziness.mdhttps://github.com/purescript-lua/purescript-lua/pull/127/files#diff-40525969b74ba582dabbc68025ddc52d26ea37f2b66bdedcde028db7ae043792
View file https://github.com/purescript-lua/purescript-lua/blob/811e3c54b4d4c5e16a8e18377791f08f62c82d65/changelog.d/20260625_191608_unisay_notes_laziness.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/purescript-lua/purescript-lua/pull/127/{{ revealButtonHref }}
lib/Language/PureScript/Backend/Lua/Fixture.hshttps://github.com/purescript-lua/purescript-lua/pull/127/files#diff-dfc024b7df4b318856630a367ba4df5944cca498cd9ce3a4135650d777d8839c
View file https://github.com/purescript-lua/purescript-lua/blob/811e3c54b4d4c5e16a8e18377791f08f62c82d65/lib/Language/PureScript/Backend/Lua/Fixture.hs
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/purescript-lua/purescript-lua/pull/127/{{ revealButtonHref }}
https://github.com/purescript-lua/purescript-lua/pull/127/files#diff-dfc024b7df4b318856630a367ba4df5944cca498cd9ce3a4135650d777d8839c
https://github.com/purescript-lua/purescript-lua/pull/127/files#diff-dfc024b7df4b318856630a367ba4df5944cca498cd9ce3a4135650d777d8839c
lib/Language/PureScript/CoreFn/Laziness.hshttps://github.com/purescript-lua/purescript-lua/pull/127/files#diff-5821eabd1e62dc7d2d0926d105e120b5d5e9d59de759a81c639cd1bd11826525
View file https://github.com/purescript-lua/purescript-lua/blob/811e3c54b4d4c5e16a8e18377791f08f62c82d65/lib/Language/PureScript/CoreFn/Laziness.hs
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/purescript-lua/purescript-lua/pull/127/{{ revealButtonHref }}
https://github.com/purescript-lua/purescript-lua/pull/127/files#diff-5821eabd1e62dc7d2d0926d105e120b5d5e9d59de759a81c639cd1bd11826525
https://github.com/purescript-lua/purescript-lua/pull/127/files#diff-5821eabd1e62dc7d2d0926d105e120b5d5e9d59de759a81c639cd1bd11826525
https://github.com/purescript-lua/purescript-lua/pull/127/files#diff-5821eabd1e62dc7d2d0926d105e120b5d5e9d59de759a81c639cd1bd11826525
https://github.com/purescript-lua/purescript-lua/pull/127/files#diff-5821eabd1e62dc7d2d0926d105e120b5d5e9d59de759a81c639cd1bd11826525
https://github.com/purescript-lua/purescript-lua/pull/127/files#diff-5821eabd1e62dc7d2d0926d105e120b5d5e9d59de759a81c639cd1bd11826525
Please reload this pagehttps://github.com/purescript-lua/purescript-lua/pull/127/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.