Title: Warn when a directive entry names a present module but matches no binding · Issue #332 · purescript-lua/purescript-lua · GitHub
Open Graph Title: Warn when a directive entry names a present module but matches no binding · Issue #332 · purescript-lua/purescript-lua
X Title: Warn when a directive entry names a present module but matches no binding · Issue #332 · purescript-lua/purescript-lua
Description: Problem Directives-file and default-pack entries are best-effort by design: an entry whose module is absent from the build is silently skipped, so one shared file can cover optional dependencies. But the same silence applies when the mod...
Open Graph Description: Problem Directives-file and default-pack entries are best-effort by design: an entry whose module is absent from the build is silently skipped, so one shared file can cover optional dependencies. B...
X Description: Problem Directives-file and default-pack entries are best-effort by design: an entry whose module is absent from the build is silently skipped, so one shared file can cover optional dependencies. B...
Opengraph URL: https://github.com/purescript-lua/purescript-lua/issues/332
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Warn when a directive entry names a present module but matches no binding","articleBody":"## Problem\n\nDirectives-file and default-pack entries are best-effort by design: an entry whose module is absent from the build is silently skipped, so one shared file can cover optional dependencies. But the same silence applies when the module IS in the build and only the target is missing — a binding renamed in a fork release, an accessor field that no longer matches the settled dictionary shape. Such an entry is dead weight and nobody finds out: the optimization it named is silently lost. For the shipped default pack (#242) this is the main staleness risk — a package-set bump that restructures an instance dictionary quietly orphans pack entries, detectable today only indirectly through golden-size regressions in this repo, which downstream users never see.\n\n## Approach\n\nThe data already exists: the translation context tracks leftover annotations, and `runRepM` computes the strict-error set by restricting them to module-header targets (`UnusedAnnotations`); the complement of that restriction is exactly the file/pack entries that matched the module but drained into no binding. Thread these out of `mkModule` as warnings instead of discarding them. Report policy by source: a leftover pack entry warns unconditionally (a stale shipped default is a compiler defect and should confess), a leftover `--directives` file entry warns only under a verbosity flag (naming a binding from a newer dependency version is legitimate for a shared file). Module-absent entries stay silent by contract, and nothing becomes a hard error — failing the build on package-set version skew would defeat the best-effort design.\n\n## Prerequisites / Relations\n\nFollow-up to #242 / PR #327 (which shipped the pack this protects). Touches the `mkModule` result type, so `compileModules`, the CLI, and the golden harness all see the new warnings channel.\n\n## Verification / Measurement\n\nUnit tests: a pack-tier entry naming a present module but no binding produces a warning; the same shape from the file tier is silent by default and reported under the flag; a module-absent entry is silent in both tiers; a matching entry warns nowhere. The golden corpus compiles warning-free with the current pack, which becomes the standing staleness check for future package-set bumps.\n","author":{"url":"https://github.com/Unisay","@type":"Person","name":"Unisay"},"datePublished":"2026-07-28T10:16:40Z","url":"https://github.com/purescript-lua/purescript-lua/issues/332"}
| 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:17307b0d-f683-1c92-6ba4-770e43002476 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | E91C:F7C4C:691AC6:8ED764:6B00D93D |
| html-safe-nonce | 578dbf676cb68cc8aa7a565c44cc80b945706d93c21e18c61145a8638f7cb729 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFOTFDOkY3QzRDOjY5MUFDNjo4RUQ3NjQ6NkIwMEQ5M0QiLCJ2aXNpdG9yX2lkIjoiMTE1MTk5NzIzODAyOTkwMDA5MyIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | f0845cc6e40dbf2e619a5343aa93ab01ebd9cac41edd6bbc2f5f1c6a8cba754c |
| hovercard-subject-tag | issue:4997440715 |
| 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/332/issue_layout |
| twitter:image | https://opengraph.githubassets.com/5f879183f5b81973952c18015d34975ee4211be053f60a927aff2ddbaf2fdd68/purescript-lua/purescript-lua/issues/332 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/5f879183f5b81973952c18015d34975ee4211be053f60a927aff2ddbaf2fdd68/purescript-lua/purescript-lua/issues/332 |
| og:image:alt | Problem Directives-file and default-pack entries are best-effort by design: an entry whose module is absent from the build is silently skipped, so one shared file can cover optional dependencies. B... |
| 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 | a481f62a1e04c9b9bdcb5628230682c66d59006f5b13b080f79cba84a176905b |
| 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 | 84c8c5cc25e2fb7f2308428458538436baecc6d2 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width