luau-lang/rfcs
1
0
Fork 0
mirror of https://github.com/luau-lang/rfcs.git synced 2025-05-04 10:43:48 +01:00
Code Issues Projects Releases Packages Wiki Activity

Initial commit

Browse source
This commit is contained in:
ffrostfall 2025-04-23 17:05:12 -04:00
parent f01741502c
commit 6ba06da7f7
1 changed files with 21 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
docs/luaurc-definition-files.md Normal file
View file

@ -0,0 +1,21 @@
# Definition Files in .luaurc Configs
## Summary
Implement a field in the `.luaurc` configuration file named "definitionFiles", which accepts an array of paths to ".d.luau" files (aka, declaration files). These definition files would be passed into the typechecker for any luau file under that configuration.
## Motivation
As cross-runtime code becomes increasingly common, the model which language servers use today (pass definition files into the API) is proving to not scale. Projects with multiple runtime targets suffer from bad editor experience, and great difficulty in getting types to be correct.
## Design
This is the bulk of the proposal. Explain the design in enough detail for somebody familiar with the language to understand, and include examples of how the feature is used.
## Drawbacks
This brings declaration files to be in a much more user-facing spot, when definition files are not meant to be user-facing.
## Alternatives
What other designs have been considered? What is the impact of not doing this?