Title: Make the runtime-lazy factory a first-class IR reference · Issue #212 · purescript-lua/purescript-lua · GitHub
Open Graph Title: Make the runtime-lazy factory a first-class IR reference · Issue #212 · purescript-lua/purescript-lua
X Title: Make the runtime-lazy factory a first-class IR reference · Issue #212 · purescript-lua/purescript-lua
Description: Self-recursive (lazy) bindings compile to a call into a runtime helper, the "runtime lazy factory". The reference to that helper travels through the IR as a bare local name, the literal string PSLUA_runtime_lazy. Nothing in the IR marks ...
Open Graph Description: Self-recursive (lazy) bindings compile to a call into a runtime helper, the "runtime lazy factory". The reference to that helper travels through the IR as a bare local name, the literal string PSLU...
X Description: Self-recursive (lazy) bindings compile to a call into a runtime helper, the "runtime lazy factory". The reference to that helper travels through the IR as a bare local name, the literal s...
Opengraph URL: https://github.com/purescript-lua/purescript-lua/issues/212
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Make the runtime-lazy factory a first-class IR reference","articleBody":"Self-recursive (lazy) bindings compile to a call into a runtime helper, the \"runtime lazy factory\". The reference to that helper travels through the IR as a bare local name, the literal string `PSLUA_runtime_lazy`. Nothing in the IR marks it as special: it looks exactly like a local variable a user could have written. So the same string ends up hard-wired independently at five sites that all have to agree, and several passes recognize the factory by comparing against that string rather than by structure.\n\nThe coupling is already documented in `Note [The PSLUA_runtime_lazy coupling]` in `Language.PureScript.Names`. The five sites:\n\n- `Names.runtimeLazyName`: the ident the laziness transform emits (`InternalIdent RuntimeLazyFactory`, whose `runIdent` is this string), so it surfaces in the IR as `Local (Name \"PSLUA_runtime_lazy\")`.\n- `Backend.Lua.Fixture.runtimeLazyName`: the name of the hand-written Lua fixture, rebuilt independently as `psluaName [name|runtime_lazy|]`. It has to mangle to the same string, or the emitted call targets a Lua local that does not exist.\n- `Backend.IR.Query.usesRuntimeLazy`: scans the linked UberModule for a free `Local (Name runtimeLazyName)` to decide whether the fixture is referenced.\n- `Backend` and `Backend.Lua.fromUberModule`: emit the fixture only when it is both needed and used.\n- `Backend.IR.Linter.unboundLocals`: seeds its scope with `runtimeLazyName` so the free reference does not trip the well-scopedness check. This is the one deliberate exemption from that invariant.\n\nRename either half of the string and the two sides stop matching: the fixture is judged unused and dropped, or the generated code calls a binding that was never emitted. Either way laziness miscompiles silently, with no type error and nothing from the linter. The linter exemption is the sharper cost. `unboundLocals` is otherwise a total well-scopedness check, and this one magic name pokes a permanent hole in it.\n\n## Proposed change\n\nRepresent the factory reference first-class in the IR instead of as a magic local name. Two shapes work:\n\n- a dedicated `RawExp` constructor for the factory reference, or\n- a single smart constructor plus a recognizer (or a pattern synonym) that every consumer routes through.\n\nThe goal is the same either way. The laziness transform emits the structured node, `usesRuntimeLazy` and the linter exemption match on it by structure rather than by string equality, and the literal `PSLUA_runtime_lazy` collapses to one definition site. Only the Lua fixture still needs the concrete Lua identifier, because Lua names are strings by nature, but the IR side stops carrying the string at all, so there is no longer a string for the two halves to disagree on. The linter exemption then becomes structural recognition of a known node instead of a name seeded into scope.\n\n`RuntimeLazyFactory` is already a constructor of `InternalIdentData`, so the factory is structured on the CoreFn / `Ident` side. What this issue asks for is preserving that structure across the CoreFn to IR boundary instead of flattening it to a string through `runIdent`.\n\n## Scope\n\nThis is the small, self-contained half of a larger observation about laziness lowering. The bigger idea, that the whole `Lazy_*` / `runtime_lazy` pair generation should move out of the CoreFn to IR boundary and into a late IR pass, is deliberately left for a separate issue: it carries real design questions (interaction with DCE and the inliner) and may not pay off, whereas this cleanup is low-risk and stands on its own. If that redesign does happen later, the factory reference wants to be first-class anyway, so this is a useful first step rather than throwaway work.\n","author":{"url":"https://github.com/Unisay","@type":"Person","name":"Unisay"},"datePublished":"2026-07-09T07:41:37Z","url":"https://github.com/purescript-lua/purescript-lua/issues/212"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:5a19ab72-de94-e86b-8489-77686459f075 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | D468:19AA62:576A3A:7108AA:6B00DB6A |
| html-safe-nonce | 16115ce572d184b8ac06d0ea6f6c9f1ba9c1c6591203bf7c2e677cda1b7dc7c5 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJENDY4OjE5QUE2Mjo1NzZBM0E6NzEwOEFBOjZCMDBEQjZBIiwidmlzaXRvcl9pZCI6IjI1MjMyNzA1NzY0MDgxNTcwMzQiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 563c3a3f0819271214b47fc3220bd045309b06589813c69152605fc4d9c0a79f |
| hovercard-subject-tag | issue:4844269012 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/purescript-lua/purescript-lua/212/issue_layout |
| twitter:image | https://opengraph.githubassets.com/c90e82966bbdf8276e9de7da61f4e9f9e32ae5f842c5c9f01a3e249f3dc279dc/purescript-lua/purescript-lua/issues/212 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/c90e82966bbdf8276e9de7da61f4e9f9e32ae5f842c5c9f01a3e249f3dc279dc/purescript-lua/purescript-lua/issues/212 |
| og:image:alt | Self-recursive (lazy) bindings compile to a call into a runtime helper, the "runtime lazy factory". The reference to that helper travels through the IR as a bare local name, the literal string PSLU... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | Unisay |
| hostname | github.com |
| expected-hostname | github.com |
| None | 043c3f30fbcbe2c6c8e729e10cbbbc90c406546f9fbbb67c648d38f6b7d16daf |
| turbo-cache-control | no-preview |
| go-import | github.com/purescript-lua/purescript-lua git https://github.com/purescript-lua/purescript-lua.git |
| octolytics-dimension-user_id | 131581790 |
| octolytics-dimension-user_login | purescript-lua |
| octolytics-dimension-repository_id | 587200487 |
| octolytics-dimension-repository_nwo | purescript-lua/purescript-lua |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 587200487 |
| octolytics-dimension-repository_network_root_nwo | purescript-lua/purescript-lua |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 5425dc24e8bd8d6fca9641a12afc984825a43875 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width