luau/Analysis/include/Luau
ariel 72f6c8b679
Sync to upstream/release/672 (#1800)
# What's Changed?

Hi there, folks! It's been another busy week in the type mines, trying
to bring you all the very best type inference system we can. We've got a
bunch of updates to large pain points across the new type solver, and
our next big update (currently under a debug flag) improving type
generalization is finally nearing completion (and should hopefully
eliminate quite a lot of "type solver failed to complete" errors). We've
also continued polishing both the CST Parser and the `Luau.Require`
library we introduced a few releases ago based on user feedback and bug
reports, and we're really happy with how they're turning out.

# Parser
- Fixes a bug in the CST tooling where the spacing on return type
annotations for functions was not being printed correctly.
- Resolves some issues with the JSON encoding of `AstGenericType` and
`AstGenericTypePack`

# Runtime
- Implements support for yielding requires in `Luau.Require` library.
- Improves the error messages for require-by-string to include the chunk
name that was problematic where possible and the overall require path
that failed to be required.
- Fixes a bug that prevented the use of `require` within C functions and
`pcall`.
- Adds an API to support selectively removing chunks from the require
cache in `Luau.Require`
- Adds an API to support clearing the entire require cache in
`Luau.Require`

# New Type Solver

- Fixes a crash in the new non-strict mode when visiting function return
types in incomplete ASTs (e.g. during editing).
- Improves type simplification to support intersections of tables with
extern types, resolving _one_ of the causes of frequent refinements
unexpectedly leading to `never`.
- Improves type inference to better understand diverging branches in
functions, reducing false negatives where the type system fails to learn
that a binding must now always be initialized.
- Fixes a typo in the type definitions for user-defined function types
where the `intersection` tag was misspelled.
- Improves the overall accuracy of free type tracking during constraint
solving, leading to better inference results overall.
- Implements `types.optional` as a new library function for user-defined
type functions to make it easier to union a type with `nil`.
- Resolves a number of bugs caused by local type inference expanding the
domain of upvalues

# Internal Contributors

Co-authored-by: Andy Friesen <afriesen@roblox.com>
Co-authored-by: Ariel Weiss <aaronweiss@roblox.com>
Co-authored-by: Hunter Goldstein <hgoldstein@roblox.com>
Co-authored-by: Talha Pathan <tpathan@roblox.com>
Co-authored-by: Varun Saini <vsaini@roblox.com>
Co-authored-by: Vighnesh Vijay <vvijay@roblox.com>

---------

Co-authored-by: Hunter Goldstein <hgoldstein@roblox.com>
Co-authored-by: Varun Saini <61795485+vrn-sn@users.noreply.github.com>
Co-authored-by: Alexander Youngblood <ayoungblood@roblox.com>
Co-authored-by: Menarul Alam <malam@roblox.com>
Co-authored-by: Aviral Goel <agoel@roblox.com>
Co-authored-by: Vighnesh <vvijay@roblox.com>
Co-authored-by: Vyacheslav Egorov <vegorov@roblox.com>
Co-authored-by: Andy Friesen <afriesen@roblox.com>
2025-05-02 14:00:23 -07:00
..
Anyification.h Sync to upstream/release/637 (#1354) 2024-08-02 07:30:04 -07:00
ApplyTypeFunction.h Sync to upstream/release/600 (#1076) 2023-10-20 18:10:30 -07:00
AstJsonEncoder.h Sync to upstream/release/539 (#625) 2022-08-04 15:35:33 -07:00
AstQuery.h Sync to upstream/release/636 (#1346) 2024-07-26 10:47:49 -07:00
Autocomplete.h Sync to upstream/release/651 (#1513) 2024-11-08 13:41:45 -08:00
AutocompleteTypes.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
BuiltinDefinitions.h Sync to upstream/release/666 (#1747) 2025-03-21 14:43:00 -07:00
Cancellation.h Sync to upstream/release/584 (#977) 2023-07-14 11:08:53 -07:00
Clone.h Sync to upstream/release/664 (#1715) 2025-03-07 10:07:27 -08:00
Constraint.h Sync to upstream/release/667 (#1754) 2025-03-28 16:15:46 -07:00
ConstraintGenerator.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
ConstraintSet.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
ConstraintSolver.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
ControlFlow.h Support Control Flow type Refinements for "break" and "continue" statements (#1004) 2023-09-21 15:28:42 -07:00
DataFlowGraph.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
DcrLogger.h Sync to upstream/release/637 (#1354) 2024-08-02 07:30:04 -07:00
Def.h Sync to upstream/release/669 (#1770) 2025-04-11 17:44:21 -07:00
Differ.h Sync to upstream/release/637 (#1354) 2024-08-02 07:30:04 -07:00
Documentation.h Sync to upstream/release/544 (#669) 2022-09-08 15:14:25 -07:00
EqSatSimplification.h Sync to upstream/release/651 (#1513) 2024-11-08 13:41:45 -08:00
EqSatSimplificationImpl.h Sync to upstream/release/662 (#1681) 2025-02-21 10:24:12 -08:00
Error.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
FileResolver.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
FragmentAutocomplete.h Sync to upstream/release/669 (#1770) 2025-04-11 17:44:21 -07:00
Frontend.h Sync to upstream/release/668 (#1760) 2025-04-04 14:11:51 -07:00
Generalization.h Sync to upstream/release/670 (#1779) 2025-04-18 13:44:39 -07:00
GlobalTypes.h Sync to upstream/release/666 (#1747) 2025-03-21 14:43:00 -07:00
InferPolarity.h Sync to upstream/release/669 (#1770) 2025-04-11 17:44:21 -07:00
InsertionOrderedMap.h Sync to upstream/release/669 (#1770) 2025-04-11 17:44:21 -07:00
Instantiation.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
Instantiation2.h Sync to upstream/release/653 (#1541) 2024-11-22 13:00:51 -08:00
IostreamHelpers.h Sync to upstream/release/600 (#1076) 2023-10-20 18:10:30 -07:00
JsonEmitter.h Sync to upstream/release/549 (#707) 2022-10-14 12:48:41 -07:00
Linter.h Sync to upstream/release/637 (#1354) 2024-08-02 07:30:04 -07:00
LValue.h Sync to upstream/release/600 (#1076) 2023-10-20 18:10:30 -07:00
Metamethods.h Sync to upstream/release/593 (#1024) 2023-09-01 10:58:27 -07:00
Module.h Sync to upstream/release/668 (#1760) 2025-04-04 14:11:51 -07:00
ModuleResolver.h Sync to upstream/release/646 (#1458) 2024-10-04 11:29:55 -07:00
NonStrictTypeChecker.h Sync to upstream/release/667 (#1754) 2025-03-28 16:15:46 -07:00
Normalize.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
NotNull.h Sync to upstream/release/555 (#768) 2022-12-02 10:09:59 -08:00
OverloadResolution.h Sync to upstream/release/655 (#1563) 2024-12-13 13:02:30 -08:00
Polarity.h Sync to upstream/release/669 (#1770) 2025-04-11 17:44:21 -07:00
Predicate.h Sync to upstream/release/600 (#1076) 2023-10-20 18:10:30 -07:00
Quantify.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
RecursionCounter.h Sync to upstream/release/558 (#796) 2023-01-06 13:14:35 -08:00
Refinement.h Sync to upstream/release/664 (#1715) 2025-03-07 10:07:27 -08:00
RequireTracer.h Sync to upstream/release/662 (#1681) 2025-02-21 10:24:12 -08:00
Scope.h Sync to upstream/release/669 (#1770) 2025-04-11 17:44:21 -07:00
Set.h Sync to upstream/release/641 (#1382) 2024-08-30 13:16:51 -07:00
Simplify.h Sync to upstream/release/670 (#1779) 2025-04-18 13:44:39 -07:00
Substitution.h Sync to upstream/release/670 (#1779) 2025-04-18 13:44:39 -07:00
Subtyping.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
Symbol.h Sync to upstream/release/588 (#992) 2023-07-28 08:13:53 -07:00
TableLiteralInference.h Sync to upstream/release/664 (#1715) 2025-03-07 10:07:27 -08:00
ToDot.h Sync to upstream/release/600 (#1076) 2023-10-20 18:10:30 -07:00
TopoSortStatements.h Sync to upstream/release/503 (#135) 2021-11-05 08:47:21 -07:00
ToString.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
Transpiler.h Sync to upstream/release/504 (#200) 2021-11-12 06:27:34 -08:00
TxnLog.h Sync to upstream/release/668 (#1760) 2025-04-04 14:11:51 -07:00
Type.h Sync to upstream/release/672 (#1800) 2025-05-02 14:00:23 -07:00
TypeArena.h Sync to upstream/release/672 (#1800) 2025-05-02 14:00:23 -07:00
TypeAttach.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
TypeChecker2.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
TypeCheckLimits.h Sync to upstream/release/588 (#992) 2023-07-28 08:13:53 -07:00
TypedAllocator.h Sync to upstream/release/541 (#644) 2022-08-18 14:32:08 -07:00
TypeFunction.h Sync to upstream/release/670 (#1779) 2025-04-18 13:44:39 -07:00
TypeFunctionReductionGuesser.h Sync to upstream/release/635 (#1337) 2024-07-19 11:20:47 -07:00
TypeFunctionRuntime.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
TypeFunctionRuntimeBuilder.h Sync to upstream/release/666 (#1747) 2025-03-21 14:43:00 -07:00
TypeFwd.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
TypeInfer.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
TypeOrPack.h Sync to upstream/release/602 (#1089) 2023-11-03 16:45:04 -07:00
TypePack.h Sync to upstream/release/672 (#1800) 2025-05-02 14:00:23 -07:00
TypePairHash.h Sync to upstream/release/601 (#1084) 2023-10-27 14:18:41 -07:00
TypePath.h Sync to upstream/release/666 (#1747) 2025-03-21 14:43:00 -07:00
TypeUtils.h Sync to upstream/release/669 (#1770) 2025-04-11 17:44:21 -07:00
Unifiable.h Sync to upstream/release/653 (#1541) 2024-11-22 13:00:51 -08:00
Unifier.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00
Unifier2.h Sync to upstream/release/669 (#1770) 2025-04-11 17:44:21 -07:00
UnifierSharedState.h Sync to upstream/release/662 (#1681) 2025-02-21 10:24:12 -08:00
VisitType.h Sync to upstream/release/671 (#1787) 2025-04-25 14:19:27 -07:00