René's URL Explorer Experiment


Title: docs: Notes for IR annotations, inlining, and newtype erasure (#44) by Unisay · Pull Request #129 · purescript-lua/purescript-lua · GitHub

Open Graph Title: docs: Notes for IR annotations, inlining, and newtype erasure (#44) by Unisay · Pull Request #129 · purescript-lua/purescript-lua

X Title: docs: Notes for IR annotations, inlining, and newtype erasure (#44) by Unisay · Pull Request #129 · purescript-lua/purescript-lua

Description: Summary Continues #44, the IR/inliner batch. Three more invariants get a GHC-style Note, each cited from its dependent sites. Comments only, so generated code, goldens, and eval oracles are unchanged. Note [Inline annotations and inlining heuristics] in IR.Inliner. Traces an @inline pragma from a module comment through parseAnnotations, the annotation map, useAnnotation, and the expression ann, to Optimizer.isInlinableExpr reading it back with getAnn. Also notes the linker's synthesised Inline.Always on foreign-field wrappers. Cited from the optimizer and linker sites. Note [Inliner annotations must all be consumed] in Backend.IR. The annotation map is a linear resource: filled by parseAnnotations, drained by useAnnotation, and checked empty by runRepM, which errors on leftovers. That check is what turns a typo'd or misplaced pragma into a reported error instead of a silent no-op. Note [Newtype constructors are erased] in Backend.IR. One convention across three isNewtype sites: construction is identity (mkConstructor), application unwraps (mkApplication), and matching skips the constructor (mkBinder). Only the matching half was hinted at before. A note on the De Bruijn item The issue also lists "namespaced De Bruijn indices" and suggests folding it into the existing Note [Sequential scoping of Let bindings]. That Note already opens with the per-name index scheme, so rather than duplicate it I just pointed the Index newtype at it with a See Note. 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 IR/inliner batch. Three more invariants get a GHC-style Note, each cited from its dependent sites. Comments only, so generated code, goldens, and eval oracles are unchang...

X Description: Summary Continues #44, the IR/inliner batch. Three more invariants get a GHC-style Note, each cited from its dependent sites. Comments only, so generated code, goldens, and eval oracles are unchang...

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

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:eebb61e5-a155-5318-21d6-8fbfdef76ee3
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-id8E64:29AEE8:C5D8FB:10901CF:6B00F9C5
html-safe-nonceb2929f74a103c314f7197f77bb4bf54d7c488eb4e37dc0bb5243453ea7e794b3
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4RTY0OjI5QUVFODpDNUQ4RkI6MTA5MDFDRjo2QjAwRjlDNSIsInZpc2l0b3JfaWQiOiIyNjUyOTcxODYyODI4NTc5MjcwIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac529cad4da1c936c41c5c99de29d988fa1b94bbae83e28d262a95218060f685d6
hovercard-subject-tagpull_request:3937425232
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/129/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 IR/inliner batch. Three more invariants get a GHC-style Note, each cited from its dependent sites. Comments only, so generated code, goldens, and eval oracles are unchang...
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/129/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpurescript-lua%2Fpurescript-lua%2Fpull%2F129%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%2F129%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/129/files
Reloadhttps://github.com/purescript-lua/purescript-lua/pull/129/files
Reloadhttps://github.com/purescript-lua/purescript-lua/pull/129/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-ir-inlinerhttps://github.com/purescript-lua/purescript-lua/tree/issue-44/notes-ir-inliner
Conversation 3 https://github.com/purescript-lua/purescript-lua/pull/129
Commits 2 https://github.com/purescript-lua/purescript-lua/pull/129/commits
Checks 2 https://github.com/purescript-lua/purescript-lua/pull/129/checks
Files changed https://github.com/purescript-lua/purescript-lua/pull/129/files
Please reload this pagehttps://github.com/purescript-lua/purescript-lua/pull/129/files
docs: Notes for IR annotations, inlining, and newtype erasure (#44) https://github.com/purescript-lua/purescript-lua/pull/129/files#top
Show all changes 2 commits https://github.com/purescript-lua/purescript-lua/pull/129/files
9b42d21 docs: Notes for IR annotations, inlining, and newtype erasure (#44) Unisay Jun 25, 2026 https://github.com/purescript-lua/purescript-lua/pull/129/commits/9b42d217d4af7ea490635bf607170bb58841a278
d2d469a docs: address Copilot review on #129 (pragma syntax, Never semantics) Unisay Jun 25, 2026 https://github.com/purescript-lua/purescript-lua/pull/129/commits/d2d469a7a616cc2eb4f8526a84654926213ed8b0
Clear filters https://github.com/purescript-lua/purescript-lua/pull/129/files
Please reload this pagehttps://github.com/purescript-lua/purescript-lua/pull/129/files
Please reload this pagehttps://github.com/purescript-lua/purescript-lua/pull/129/files
20260625_201941_unisay_notes_ir_inliner.md https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-c725d3eacdf418926286aa044fd88e35dfc68c882a3c828507eaa048e38d6df8
IR.hs https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
Inliner.hs https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-88f05601faa8e18c6ea74b2f47a6e89ed662c05acf8ac019af8104727ae0d7ed
Linker.hs https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-114e667388f6a8a686b7993566e51078f236daa12b3d6da94e4935c60f7c3400
Optimizer.hs https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-487ead9d0ca9c3e6f68e23c604b0ae9070089e0dd0f7d214cdce5fbc878f3315
Types.hs https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-c628fb950daac01f47dc80a039e24b8b452f9d578ab0d55483d10758027b4884
changelog.d/20260625_201941_unisay_notes_ir_inliner.mdhttps://github.com/purescript-lua/purescript-lua/pull/129/files#diff-c725d3eacdf418926286aa044fd88e35dfc68c882a3c828507eaa048e38d6df8
View file https://github.com/purescript-lua/purescript-lua/blob/d2d469a7a616cc2eb4f8526a84654926213ed8b0/changelog.d/20260625_201941_unisay_notes_ir_inliner.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/purescript-lua/purescript-lua/pull/129/{{ revealButtonHref }}
lib/Language/PureScript/Backend/IR.hshttps://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
View file https://github.com/purescript-lua/purescript-lua/blob/d2d469a7a616cc2eb4f8526a84654926213ed8b0/lib/Language/PureScript/Backend/IR.hs
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/purescript-lua/purescript-lua/pull/129/{{ revealButtonHref }}
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-b2e6467526a4a74dfd4d619dae7237fb05d5ad4386d4f8a893d4f82b4c31cd39
lib/Language/PureScript/Backend/IR/Inliner.hshttps://github.com/purescript-lua/purescript-lua/pull/129/files#diff-88f05601faa8e18c6ea74b2f47a6e89ed662c05acf8ac019af8104727ae0d7ed
View file https://github.com/purescript-lua/purescript-lua/blob/d2d469a7a616cc2eb4f8526a84654926213ed8b0/lib/Language/PureScript/Backend/IR/Inliner.hs
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/purescript-lua/purescript-lua/pull/129/{{ revealButtonHref }}
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-88f05601faa8e18c6ea74b2f47a6e89ed662c05acf8ac019af8104727ae0d7ed
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-88f05601faa8e18c6ea74b2f47a6e89ed662c05acf8ac019af8104727ae0d7ed
lib/Language/PureScript/Backend/IR/Linker.hshttps://github.com/purescript-lua/purescript-lua/pull/129/files#diff-114e667388f6a8a686b7993566e51078f236daa12b3d6da94e4935c60f7c3400
View file https://github.com/purescript-lua/purescript-lua/blob/d2d469a7a616cc2eb4f8526a84654926213ed8b0/lib/Language/PureScript/Backend/IR/Linker.hs
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/purescript-lua/purescript-lua/pull/129/{{ revealButtonHref }}
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-114e667388f6a8a686b7993566e51078f236daa12b3d6da94e4935c60f7c3400
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-114e667388f6a8a686b7993566e51078f236daa12b3d6da94e4935c60f7c3400
lib/Language/PureScript/Backend/IR/Optimizer.hshttps://github.com/purescript-lua/purescript-lua/pull/129/files#diff-487ead9d0ca9c3e6f68e23c604b0ae9070089e0dd0f7d214cdce5fbc878f3315
View file https://github.com/purescript-lua/purescript-lua/blob/d2d469a7a616cc2eb4f8526a84654926213ed8b0/lib/Language/PureScript/Backend/IR/Optimizer.hs
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/purescript-lua/purescript-lua/pull/129/{{ revealButtonHref }}
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-487ead9d0ca9c3e6f68e23c604b0ae9070089e0dd0f7d214cdce5fbc878f3315
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-487ead9d0ca9c3e6f68e23c604b0ae9070089e0dd0f7d214cdce5fbc878f3315
lib/Language/PureScript/Backend/IR/Types.hshttps://github.com/purescript-lua/purescript-lua/pull/129/files#diff-c628fb950daac01f47dc80a039e24b8b452f9d578ab0d55483d10758027b4884
View file https://github.com/purescript-lua/purescript-lua/blob/d2d469a7a616cc2eb4f8526a84654926213ed8b0/lib/Language/PureScript/Backend/IR/Types.hs
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/purescript-lua/purescript-lua/pull/129/{{ revealButtonHref }}
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-c628fb950daac01f47dc80a039e24b8b452f9d578ab0d55483d10758027b4884
https://github.com/purescript-lua/purescript-lua/pull/129/files#diff-c628fb950daac01f47dc80a039e24b8b452f9d578ab0d55483d10758027b4884
Please reload this pagehttps://github.com/purescript-lua/purescript-lua/pull/129/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.