CHANGELOG.md

# Changelog

## 0.0.69

Released on 2026-08-06.

### Core type checking

- `isinstance` narrowing for generic classes is now more gradual by default ([#27308](https://github.com/astral-sh/ruff/pull/27308))

    This new behavior is more similar to what other major type checkers do. For example:

    ```py
    def f(xs: object):
        if isinstance(xs, list):
            reveal_type(xs)  # now: `list[Unknown]`, before: `Top[list[Unknown]]`
    ```

    **Note**: you might consider enabling [`analysis.strict-generic-narrowing`](https://docs.astral.sh/ty/reference/configuration/#strict-generic-narrowing)
    if you prefer the strictly correct behavior.

### Contributors

- [@sharkdp](https://github.com/sharkdp)

## 0.0.68

Released on 2026-08-05.

### Diagnostics

- Preserve property getter call errors ([#27509](https://github.com/astral-sh/ruff/pull/27509))
- Simplify numeric tower displays (e.g., `float` over `int | float`) ([#27406](https://github.com/astral-sh/ruff/pull/27406))
- Suggest closing open `TypedDict` types for `Mapping` compatibility ([#27512](https://github.com/astral-sh/ruff/pull/27512))

### Core type checking

- Avoid double inference of `Unpack` operands in `Union` ([#27525](https://github.com/astral-sh/ruff/pull/27525))
- Fix panic from mismatched OR-pattern bindings ([#27533](https://github.com/astral-sh/ruff/pull/27533))

### Contributors

- [@AlexWaygood](https://github.com/AlexWaygood)
- [@charliermarsh](https://github.com/charliermarsh)
- [@carljm](https://github.com/carljm)

## 0.0.67

Released on 2026-08-05.

### LSP server

- Fix unused hints for OR-pattern captures ([#27438](https://github.com/astral-sh/ruff/pull/27438))
- Index match-pattern bindings as symbols ([#27260](https://github.com/astral-sh/ruff/pull/27260))
- Retain typing-only symbols in explicit completions ([#27435](https://github.com/astral-sh/ruff/pull/27435))

### Diagnostics

- Preserve called types in intersection diagnostics ([#27475](https://github.com/astral-sh/ruff/pull/27475))
- Suppress `unimported-reveal` diagnostics in stub files and `if TYPE_CHECKING` blocks ([#27508](https://github.com/astral-sh/ruff/pull/27508))

### Configuration

- Remove deprecated `src.root` setting in favor of `environment.root` ([#27456](https://github.com/astral-sh/ruff/pull/27456))

### Core type checking

- Check property compatibility when matching class objects to protocols ([#27402](https://github.com/astral-sh/ruff/pull/27402))
- Fix constructor calls on narrowed type-variable intersections ([#27493](https://github.com/astral-sh/ruff/pull/27493))
- Fix specialization cycle with deferred TypeVar defaults ([#27453](https://github.com/astral-sh/ruff/pull/27453))
- Infer generic TypedDicts from unpacked TypedDicts ([#27439](https://github.com/astral-sh/ruff/pull/27439))
- Infer generic TypedDicts through synthesized constructor signatures ([#27436](https://github.com/astral-sh/ruff/pull/27436))
- Normalize unpacked callable signatures for assignability ([#27450](https://github.com/astral-sh/ruff/pull/27450))
- Preserve class type parameters through generic decorators ([#27442](https://github.com/astral-sh/ruff/pull/27442))
- Preserve generic class type variables in constructor inference ([#27340](https://github.com/astral-sh/ruff/pull/27340))
- Preserve return constraints for object-variadic callables ([#27431](https://github.com/astral-sh/ruff/pull/27431))
- Preserve return constraints for top callables ([#27446](https://github.com/astral-sh/ruff/pull/27446))
- Recover generic constructor types from failing overloads ([#27460](https://github.com/astral-sh/ruff/pull/27460))
- Reject Self with incompatible explicit receiver annotations ([#27454](https://github.com/astral-sh/ruff/pull/27454))
- Reject unhashable objects for Hashable protocols ([#27441](https://github.com/astral-sh/ruff/pull/27441))
- Reject unsupported `dataclass_transform` parameters ([#27458](https://github.com/astral-sh/ruff/pull/27458))
- Restore bottom callable subtyping for gradual prefixes ([#27519](https://github.com/astral-sh/ruff/pull/27519))
- Top-materialize `is_dataclass` type guard ([#27455](https://github.com/astral-sh/ruff/pull/27455))
- Validate constructor calls on unbounded type variables ([#27449](https://github.com/astral-sh/ruff/pull/27449))

### Performance

- Avoid exponential slowdown copying narrowed TypedDict unions ([#27492](https://github.com/astral-sh/ruff/pull/27492))

### Contributors

- [@Punisheroot](https://github.com/Punisheroot)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@sharkdp](https://github.com/sharkdp)
- [@MichaReiser](https://github.com/MichaReiser)
- [@carljm](https://github.com/carljm)
- [@charliermarsh](https://github.com/charliermarsh)

## 0.0.66

Released on 2026-08-03.

### LSP server

- Index `with`-statement targets as symbols ([#27256](https://github.com/astral-sh/ruff/pull/27256))
- Trigger signature help after completing callable with parentheses ([#27084](https://github.com/astral-sh/ruff/pull/27084))

### Library support

- Pydantic: Recognize models installed on extra search paths ([#27429](https://github.com/astral-sh/ruff/pull/27429))

### Diagnostics

- Detect `__aenter__` and `__aexit__` that do not return awaitables ([#27414](https://github.com/astral-sh/ruff/pull/27414))
- Diagnose dataclass fields after inherited defaults ([#27327](https://github.com/astral-sh/ruff/pull/27327))
- Emit diagnostic when specializing a non-generic class ([#26883](https://github.com/astral-sh/ruff/pull/26883))
- Improve error context for incompatible callable signatures ([#27422](https://github.com/astral-sh/ruff/pull/27422))
- Preserve forwarded expanded-variadic diagnostic sources ([#27266](https://github.com/astral-sh/ruff/pull/27266))

### Core type checking

- Avoid over-materializing user-defined `TypeIs` return types ([#26864](https://github.com/astral-sh/ruff/pull/26864))
- Fix enum class container assignability ([#27318](https://github.com/astral-sh/ruff/pull/27318))
- Hide stub-only helpers from implicit builtin lookup ([#27423](https://github.com/astral-sh/ruff/pull/27423))
- Move `Unknown` out of the experimental `ty_extensions` API ([#27430](https://github.com/astral-sh/ruff/pull/27430))
- Preserve `TypeVarTuple` context during `Generic` recovery ([#27381](https://github.com/astral-sh/ruff/pull/27381))
- Preserve exact numeric types in covariant collections ([#27311](https://github.com/astral-sh/ruff/pull/27311))
- Reject `ClassVar` and `Final` qualifiers in `NamedTuple` fields ([#27380](https://github.com/astral-sh/ruff/pull/27380))
- Reject out-of-scope `ParamSpec` components ([#27378](https://github.com/astral-sh/ruff/pull/27378))
- Reject specializing non-generic subclasses ([#27377](https://github.com/astral-sh/ruff/pull/27377))
- Respect bounds and constraints in generic materializations ([#27228](https://github.com/astral-sh/ruff/pull/27228))
- Sync vendored typeshed stubs ([#27401](https://github.com/astral-sh/ruff/pull/27401)). [Typeshed diff](https://github.com/python/typeshed/compare/b00c387c669cb50d5d388d77b74c2e832e147fe8...1b116673774d062a4af7b0a0b3d05533a6be55d0)

### Contributors

- [@dhruvmanila](https://github.com/dhruvmanila)
- [@carljm](https://github.com/carljm)
- [@Punisheroot](https://github.com/Punisheroot)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@cheparity](https://github.com/cheparity)
- [@BitWeaverDev](https://github.com/BitWeaverDev)
- [@charliermarsh](https://github.com/charliermarsh)
- [@ribru17](https://github.com/ribru17)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.65

Released on 2026-07-29.

### LSP server

- Support comprehension walruses in IDE features ([#26476](https://github.com/astral-sh/ruff/pull/26476))

### Library support

- Pydantic: Allow mutation of private attributes on frozen models ([#27257](https://github.com/astral-sh/ruff/pull/27257))
- Pydantic: Synthesize `__replace__` for models ([#27220](https://github.com/astral-sh/ruff/pull/27220))

### Diagnostics

- Correct `ParamSpec` forwarded-argument diagnostic locations ([#27263](https://github.com/astral-sh/ruff/pull/27263))
- Recover forwarded callable object and constructor sources ([#27264](https://github.com/astral-sh/ruff/pull/27264))
- Recover forwarded `functools.partial` diagnostic sources ([#27265](https://github.com/astral-sh/ruff/pull/27265))

### Core type checking

- Fix gradual class assignability with generic receivers ([#27223](https://github.com/astral-sh/ruff/pull/27223))
- Lazily materialize protocol attributes ([#27267](https://github.com/astral-sh/ruff/pull/27267))
- Narrow tagged unions through all type kinds ([#27226](https://github.com/astral-sh/ruff/pull/27226))
- Prefer static constrained TypeVar solutions ([#27057](https://github.com/astral-sh/ruff/pull/27057))
- Preserve frozen-dataclass setter delegation ([#27217](https://github.com/astral-sh/ruff/pull/27217))
- Preserve inference when filtering constructor overloads ([#27254](https://github.com/astral-sh/ruff/pull/27254))
- Reject frozen-dataclass field deletion through subclasses ([#27001](https://github.com/astral-sh/ruff/pull/27001))
- Stabilize recursive type-constraint ordering ([#27176](https://github.com/astral-sh/ruff/pull/27176))
- Support materialized class type expressions ([#27258](https://github.com/astral-sh/ruff/pull/27258))

### Performance

- Avoid quadratic inference for large literal unions ([#27178](https://github.com/astral-sh/ruff/pull/27178))
- Cache protocol receiver binding ([#27301](https://github.com/astral-sh/ruff/pull/27301))

### Contributors

- [@thejchap](https://github.com/thejchap)
- [@benedikt-bartscher](https://github.com/benedikt-bartscher)
- [@carljm](https://github.com/carljm)
- [@charliermarsh](https://github.com/charliermarsh)

## 0.0.64

Released on 2026-07-27.

### Bug fixes

- Fix identity narrowing for NewTypes ([#26439](https://github.com/astral-sh/ruff/pull/26439))
- Make reachability analysis idempotent ([#27163](https://github.com/astral-sh/ruff/pull/27163))

### LSP server

- Fix ParamSpec declaration hover and type navigation ([#27183](https://github.com/astral-sh/ruff/pull/27183))
- Implement LSP `textDocument/implementation` request ([#25410](https://github.com/astral-sh/ruff/pull/25410))
- Introduce shared primitives for parsing backticks in docstrings ([#26928](https://github.com/astral-sh/ruff/pull/26928))
- Render NumPy docstrings as structured Markdown ([#25925](https://github.com/astral-sh/ruff/pull/25925))

### CLI

- Add `--exclude-scripts` and `--include-scripts` ([#27169](https://github.com/astral-sh/ruff/pull/27169))
- Discover uv workspace roots ([#25551](https://github.com/astral-sh/ruff/pull/25551))

### Diagnostics

- Add a lint rule for combined abstract and final decorators ([#26932](https://github.com/astral-sh/ruff/pull/26932))
- Change `--add-ignore` to add space after the colon for `ty: ignore` ([#27120](https://github.com/astral-sh/ruff/pull/27120))
- Fix `missing-override-decorator` suggestion before Python 3.12 ([#27166](https://github.com/astral-sh/ruff/pull/27166))
- Reuse full call diagnostics for implicit setter calls ([#27115](https://github.com/astral-sh/ruff/pull/27115))

### Configuration

- Allow unresolved unused venv home paths ([#27162](https://github.com/astral-sh/ruff/pull/27162))
- Simplify script metadata query ([#27121](https://github.com/astral-sh/ruff/pull/27121))

### Core type checking

- Decorate only overload implementation signatures ([#27147](https://github.com/astral-sh/ruff/pull/27147))
- Don't consider known-instance types, generic aliases or non-singleton special-form types to be single-valued ([#27137](https://github.com/astral-sh/ruff/pull/27137))
- Improve identity comparison inference for singleton types ([#27126](https://github.com/astral-sh/ruff/pull/27126))
- Improve tuple membership and rich comparison inference ([#27164](https://github.com/astral-sh/ruff/pull/27164))
- Model walrus bindings from comprehensions ([#26466](https://github.com/astral-sh/ruff/pull/26466))
- Narrow tagged unions using identity comparisons ([#27130](https://github.com/astral-sh/ruff/pull/27130))
- Preserve `Self` in `__new__` calls ([#27003](https://github.com/astral-sh/ruff/pull/27003))
- Preserve receiver constraints when binding overloaded methods ([#27038](https://github.com/astral-sh/ruff/pull/27038))
- Support generic manual PEP 695 type aliases ([#27083](https://github.com/astral-sh/ruff/pull/27083))
- Treat bivariance as covariant ([#24319](https://github.com/astral-sh/ruff/pull/24319))

### Performance

- Avoid cycles when resolving `ModuleType` globals ([#27182](https://github.com/astral-sh/ruff/pull/27182))
- Avoid expanding optional enum comparisons ([#27105](https://github.com/astral-sh/ruff/pull/27105))
- Avoid repeated inference when copying mixed `TypedDict` unions ([#27108](https://github.com/astral-sh/ruff/pull/27108))
- Improve importer performance ([#27159](https://github.com/astral-sh/ruff/pull/27159))
- Improve union and intersection builder performance ([#27167](https://github.com/astral-sh/ruff/pull/27167))

### Contributors

- [@perfloop-agent](https://github.com/perfloop-agent)
- [@carljm](https://github.com/carljm)
- [@lerebear](https://github.com/lerebear)
- [@Gankra](https://github.com/Gankra)
- [@TrapsterDK](https://github.com/TrapsterDK)
- [@MichaReiser](https://github.com/MichaReiser)
- [@thejchap](https://github.com/thejchap)
- [@mtshiba](https://github.com/mtshiba)
- [@denyszhak](https://github.com/denyszhak)
- [@charliermarsh](https://github.com/charliermarsh)
- [@AlexWaygood](https://github.com/AlexWaygood)

## 0.0.63

Released on 2026-07-23.

### Core type checking

- Handle generic stringified PEP 613 (`typing.TypeAlias`) type aliases ([#27092](https://github.com/astral-sh/ruff/pull/27092))
- Allow equality narrowing across non-final classes ([#27031](https://github.com/astral-sh/ruff/pull/27031))
- Allow interpolated string literals to be promoted to `str` ([#27104](https://github.com/astral-sh/ruff/pull/27104))
- Fix double specialization of generic type aliases ([#27058](https://github.com/astral-sh/ruff/pull/27058))
- Fix intersections of `type` and `TypeForm` ([#27099](https://github.com/astral-sh/ruff/pull/27099))
- When narrowing from a `match` statement leads a variable `x` to be inferred as `A & B`, infer the type of `x.attr` as `<type of A.attr> & <type of B.attr>` ([#27103](https://github.com/astral-sh/ruff/pull/27103))

### Library support

- Pydantic: Stricter validation of sub-model fields in lax mode ([#27091](https://github.com/astral-sh/ruff/pull/27091))
- Pydantic: Support special underscore parameters in `BaseSettings` models ([#27098](https://github.com/astral-sh/ruff/pull/27098))

### Performance

- Avoid exponential narrowing of optional dynamic `match` subjects ([#27100](https://github.com/astral-sh/ruff/pull/27100))
- Avoid normalizing cached absolute file paths ([#26998](https://github.com/astral-sh/ruff/pull/26998))

### Contributors

- [@sharkdp](https://github.com/sharkdp)
- [@charliermarsh](https://github.com/charliermarsh)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@carljm](https://github.com/carljm)

## 0.0.62

Released on 2026-07-21.

### Bug fixes

- Guard recursive `Protocol` and `TypedDict` relations ([#26990](https://github.com/astral-sh/ruff/pull/26990))
- Prevent stack overflows in recursive type relation checks ([#26503](https://github.com/astral-sh/ruff/pull/26503))
- Recover from cancelled file indexing ([#26876](https://github.com/astral-sh/ruff/pull/26876))

### Diagnostics

- Avoid editing ignore comments with trailing reasons ([#26939](https://github.com/astral-sh/ruff/pull/26939))
- Prefer innermost inline suppressions ([#26940](https://github.com/astral-sh/ruff/pull/26940))
- Remove unused own-line ignore comments ([#27013](https://github.com/astral-sh/ruff/pull/27013))
- Reuse applicable own-line suppressions in `--add-ignore` ([#26925](https://github.com/astral-sh/ruff/pull/26925))

### Configuration

- Respect `rules` and `analysis` in PEP 723 script metadata configurations ([#26671](https://github.com/astral-sh/ruff/pull/26671))

### Core type checking

- Accept gradual constrained TypeVar solutions ([#26965](https://github.com/astral-sh/ruff/pull/26965))
- Avoid recursive TypeVarTuple alias expansion ([#27032](https://github.com/astral-sh/ruff/pull/27032))
- Check inherited method conflicts via the MRO ([#27019](https://github.com/astral-sh/ruff/pull/27019))
- Contextually infer custom `__setattr__` assignments ([#27015](https://github.com/astral-sh/ruff/pull/27015))
- Fix `Callable` `isinstance` reachability ([#26970](https://github.com/astral-sh/ruff/pull/26970))
- Fix `Just[float]` protocol matching ([#27053](https://github.com/astral-sh/ruff/pull/27053))
- Fix `Self` binding for classmethod `__new__` constructors ([#27030](https://github.com/astral-sh/ruff/pull/27030))
- Fix nested short-circuit flow snapshots ([#26956](https://github.com/astral-sh/ruff/pull/26956))
- Gate `TypedDict` PEP 728 parameters by Python version ([#26968](https://github.com/astral-sh/ruff/pull/26968))
- Improve `match` reachability inference around value-pattern branches ([#26979](https://github.com/astral-sh/ruff/pull/26979))
- Make membership and equality narrowing consistent ([#26982](https://github.com/astral-sh/ruff/pull/26982))
- Preserve constrained TypeVar equality narrowing ([#26988](https://github.com/astral-sh/ruff/pull/26988))
- Preserve constrained TypeVar inequality narrowing ([#26995](https://github.com/astral-sh/ruff/pull/26995))
- Preserve unsatisfiable generic call constraints ([#26964](https://github.com/astral-sh/ruff/pull/26964))
- Respect bounded typevars in union inference ([#27023](https://github.com/astral-sh/ruff/pull/27023))
- Respect metaclass `__setattr__` for class attributes ([#27000](https://github.com/astral-sh/ruff/pull/27000))

### Performance

- Cache non-terminal-call reachability prefixes ([#26810](https://github.com/astral-sh/ruff/pull/26810))
- Cache protocol `Self` binding ([#26997](https://github.com/astral-sh/ruff/pull/26997))
- Cache sparse reachability checkpoints ([#26811](https://github.com/astral-sh/ruff/pull/26811))
- Defer statement-call narrowing gates ([#26793](https://github.com/astral-sh/ruff/pull/26793))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@MichaReiser](https://github.com/MichaReiser)
- [@carljm](https://github.com/carljm)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@mtshiba](https://github.com/mtshiba)

## 0.0.61

Released on 2026-07-17.

### Bug fixes

- Avoid recursive protocol structural comparisons ([#26721](https://github.com/astral-sh/ruff/pull/26721))

### LSP server

- Render Google docstrings as structured Markdown ([#26599](https://github.com/astral-sh/ruff/pull/26599))

### Library support

- Pydantic: Collect field metadata through subscripted generic `Annotated` aliases ([#26885](https://github.com/astral-sh/ruff/pull/26885))

### Diagnostics

- Avoid extending own-line suppressions in `--add-ignore` ([#26808](https://github.com/astral-sh/ruff/pull/26808))

### Core type checking

- Derive descriptor setter domains for protocols ([#26683](https://github.com/astral-sh/ruff/pull/26683))
- Enforce declared receiver TypeVar domains ([#26863](https://github.com/astral-sh/ruff/pull/26863))
- Infer `isinstance` results for aliases and type variables ([#26961](https://github.com/astral-sh/ruff/pull/26961))
- Infer `isinstance` results for fixed class tuples ([#26935](https://github.com/astral-sh/ruff/pull/26935))
- Narrow inline list and set membership checks ([#26955](https://github.com/astral-sh/ruff/pull/26955))
- Narrow tagged unions by tag truthiness ([#26887](https://github.com/astral-sh/ruff/pull/26887))
- Narrow walrus expression values ([#26949](https://github.com/astral-sh/ruff/pull/26949))
- Project intersections in `to_instance` ([#26892](https://github.com/astral-sh/ruff/pull/26892))
- Remove inferable TypeVar artifacts recursively ([#26787](https://github.com/astral-sh/ruff/pull/26787))
- Respect mixin receiver domains in method overrides ([#26941](https://github.com/astral-sh/ruff/pull/26941))
- Support `TypeVarTuple` and `Unpack` ([#25240](https://github.com/astral-sh/ruff/pull/25240))

### Performance

- Deduplicate completion labels ([#26890](https://github.com/astral-sh/ruff/pull/26890))
- Only collect expected types for files open in the editor ([#25546](https://github.com/astral-sh/ruff/pull/25546))
- Parallelize subtype hierarchy search ([#26875](https://github.com/astral-sh/ruff/pull/26875))
- Share heap-backed parser names with CharStr ([#26594](https://github.com/astral-sh/ruff/pull/26594))
- Use the new incremental checker from the `ignore` crate ([#26933](https://github.com/astral-sh/ruff/pull/26933))

### Contributors

- [@MichaReiser](https://github.com/MichaReiser)
- [@denyszhak](https://github.com/denyszhak)
- [@lerebear](https://github.com/lerebear)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@charliermarsh](https://github.com/charliermarsh)
- [@BurntSushi](https://github.com/BurntSushi)
- [@Aethryl](https://github.com/Aethryl)
- [@carljm](https://github.com/carljm)
- [@ibraheemdev](https://github.com/ibraheemdev)

## 0.0.60

Released on 2026-07-15.

### Bug fixes

- Expand transparent callable workaround with overloads and `Awaitable[T]` ([#26761](https://github.com/astral-sh/ruff/pull/26761))
- Separate type-mapping caches by transformation mode ([#26857](https://github.com/astral-sh/ruff/pull/26857))
- Avoid recursive protocol union redundancy checks ([#26689](https://github.com/astral-sh/ruff/pull/26689))
- Handle recursive protocols in redundant-cast checks ([#26708](https://github.com/astral-sh/ruff/pull/26708))

### LSP server

- Prevent type that is written with a code span from being incorrectly re-wrapped during docstring Markdown rendering ([#26723](https://github.com/astral-sh/ruff/pull/26723))

### Library support

- Pydantic: Support `populate_by_name` and custom initializers ([#26764](https://github.com/astral-sh/ruff/pull/26764))
- Pydantic: Warn about immediately discarded extra arguments ([#26762](https://github.com/astral-sh/ruff/pull/26762))

### Diagnostics

- Narrow TypeGuard keyword arguments and remove `invalid-type-guard-call` ([#26809](https://github.com/astral-sh/ruff/pull/26809))
- Support own-line suppression comments ([#26785](https://github.com/astral-sh/ruff/pull/26785))

### Core type checking

- Derive descriptor setter domains for protocols ([#26683](https://github.com/astral-sh/ruff/pull/26683))
- Handle cycles in derived constraint relations ([#26814](https://github.com/astral-sh/ruff/pull/26814))
- Implement unified generic call inference ([#26141](https://github.com/astral-sh/ruff/pull/26141))
- Preserve constraints from bound receivers ([#26776](https://github.com/astral-sh/ruff/pull/26776))
- Project exact-length narrowing through TypeVars ([#26852](https://github.com/astral-sh/ruff/pull/26852))
- Resolve PEP 695 aliases in type[...] annotations ([#26842](https://github.com/astral-sh/ruff/pull/26842))
- Retain sequence pattern narrowing in successful `match` cases ([#26807](https://github.com/astral-sh/ruff/pull/26807))
- Support class and static protocol methods ([#26574](https://github.com/astral-sh/ruff/pull/26574))
- Support class objects satisfying instance-method protocols ([#26789](https://github.com/astral-sh/ruff/pull/26789))
- Support `type[Protocol]` ([#26649](https://github.com/astral-sh/ruff/pull/26649))
- Sync vendored typeshed stubs ([#26840](https://github.com/astral-sh/ruff/pull/26840)). [Typeshed diff](https://github.com/python/typeshed/compare/b9090e99745ac1511d8efd828622b11a9a3623e8...b00c387c669cb50d5d388d77b74c2e832e147fe8)
- Treat transparent callable decorators consistently in class assignments ([#26720](https://github.com/astral-sh/ruff/pull/26720))

### Performance

- Compare overloaded protocol method returns pairwise ([#26684](https://github.com/astral-sh/ruff/pull/26684))
- Extend `PathBounds` fast-path to support both upper and lower bounds ([#26782](https://github.com/astral-sh/ruff/pull/26782))
- Skip `Self` type scans for non-generic instances ([#26703](https://github.com/astral-sh/ruff/pull/26703))

### Contributors

- [@sharkdp](https://github.com/sharkdp)
- [@mtshiba](https://github.com/mtshiba)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@lerebear](https://github.com/lerebear)
- [@carljm](https://github.com/carljm)
- [@charliermarsh](https://github.com/charliermarsh)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@RasmusNygren](https://github.com/RasmusNygren)

## 0.0.59

Released on 2026-07-12.

### Bug fixes

- Guard descriptor classification cycles ([#26690](https://github.com/astral-sh/ruff/pull/26690))
- Respect `init=False` in dataclass field-order checks ([#26749](https://github.com/astral-sh/ruff/pull/26749))
- Avoid duplicate diagnostics for overloaded TypeIs ([#26716](https://github.com/astral-sh/ruff/pull/26716))

### Library support

- Pydantic: Support custom `__init__` methods ([#26699](https://github.com/astral-sh/ruff/pull/26699))
- Pydantic: Support field metadata in `Annotated` ([#26650](https://github.com/astral-sh/ruff/pull/26650))

### Core type checking

- Allow unsound equality-based narrowing for builtins ([#26414](https://github.com/astral-sh/ruff/pull/26414))
- Bind Self in implicit dunder calls ([#26711](https://github.com/astral-sh/ruff/pull/26711))
- Correct protocol method receiver binding ([#26701](https://github.com/astral-sh/ruff/pull/26701))
- Exempt ParamSpec callables from the dunder descriptor heuristic ([#26696](https://github.com/astral-sh/ruff/pull/26696))
- Remove transitive TypeVar artifacts during collection inference ([#26714](https://github.com/astral-sh/ruff/pull/26714))

### LSP server

- Avoid broad invalidation from file check eligibility ([#26741](https://github.com/astral-sh/ruff/pull/26741))
- Correct how we expand tabs in docstrings ([#26679](https://github.com/astral-sh/ruff/pull/26679))
- Resolve ambiguity in Google-style docstring parsing in favour of observations from popular projects ([#26673](https://github.com/astral-sh/ruff/pull/26673))

### CLI

- Avoid allocation for every stdout write ([#26698](https://github.com/astral-sh/ruff/pull/26698))
- Buffer diagnostic output ([#26702](https://github.com/astral-sh/ruff/pull/26702))

### Performance

- Cache generic context ([#26745](https://github.com/astral-sh/ruff/pull/26745))
- Cache known class instances ([#26746](https://github.com/astral-sh/ruff/pull/26746))
- Reuse common TypedDict constraints through intersections ([#26747](https://github.com/astral-sh/ruff/pull/26747))
- Use purpose-specific types for completion and module text ([#26664](https://github.com/astral-sh/ruff/pull/26664))

### Contributors

- [@carljm](https://github.com/carljm)
- [@MichaReiser](https://github.com/MichaReiser)
- [@charliermarsh](https://github.com/charliermarsh)
- [@lerebear](https://github.com/lerebear)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.58

Released on 2026-07-09.

### Bug fixes

- Fix protocol matching for class variables ([#26669](https://github.com/astral-sh/ruff/pull/26669))
- Fix reflected binary dispatch for runtime classes ([#26623](https://github.com/astral-sh/ruff/pull/26623))
- Support cached properties in protocols ([#26681](https://github.com/astral-sh/ruff/pull/26681))

### Diagnostics

- Add assignability context to upper-bound diagnostics ([#26645](https://github.com/astral-sh/ruff/pull/26645))
- Add blanket ignore comment rule ([#26426](https://github.com/astral-sh/ruff/pull/26426))
- Improve protocol attribute diagnostic context ([#26644](https://github.com/astral-sh/ruff/pull/26644))

### Library support

- Pydantic: Add fields from mixin classes ([#26631](https://github.com/astral-sh/ruff/pull/26631))
- Pydantic: Add support for `validate_by_{name,alias}` ([#26598](https://github.com/astral-sh/ruff/pull/26598))
- Pydantic: Add support for `validation_alias` ([#26629](https://github.com/astral-sh/ruff/pull/26629))
- Pydantic: Fix float conversion in unions ([#26655](https://github.com/astral-sh/ruff/pull/26655))
- Pydantic: Ignore private attributes ([#26630](https://github.com/astral-sh/ruff/pull/26630))
- Pydantic: Make `BaseSettings` fields optional by default ([#26628](https://github.com/astral-sh/ruff/pull/26628))
- Pydantic: Recognize frozen models via config ([#26648](https://github.com/astral-sh/ruff/pull/26648))
- Pydantic: Support dict model configurations ([#26632](https://github.com/astral-sh/ruff/pull/26632))
- Pydantic: Support validation of `RootModel` fields ([#26634](https://github.com/astral-sh/ruff/pull/26634))
- Pydantic: Understand ellipsis as providing no default value ([#26637](https://github.com/astral-sh/ruff/pull/26637))

### Core type checking

- Gate membership narrowing on `__contains__` semantics ([#25964](https://github.com/astral-sh/ruff/pull/25964))
- Handle callable classes in solver ([#26090](https://github.com/astral-sh/ruff/pull/26090))
- Infer `ModuleType.__doc__` as `str` in the presence of a docstring ([#26505](https://github.com/astral-sh/ruff/pull/26505))
- Infer metaclass-declared attributes on class instances ([#26512](https://github.com/astral-sh/ruff/pull/26512))
- Respect user stub overlays during module resolution ([#26123](https://github.com/astral-sh/ruff/pull/26123))

### Performance

- Avoid allocating decorated parameter names ([#26666](https://github.com/astral-sh/ruff/pull/26666))
- Optimize `TypeCollector` ([#26593](https://github.com/astral-sh/ruff/pull/26593))

### Contributors

- [@carljm](https://github.com/carljm)
- [@charliermarsh](https://github.com/charliermarsh)
- [@mtshiba](https://github.com/mtshiba)
- [@MichaReiser](https://github.com/MichaReiser)
- [@sharkdp](https://github.com/sharkdp)
- [@kaapstorm](https://github.com/kaapstorm)

## 0.0.57

Released on 2026-07-07.

### Bug fixes

- Detect async generator expressions containing await ([#26568](https://github.com/astral-sh/ruff/pull/26568))
- Preserve exhaustive gradual match patterns ([#26523](https://github.com/astral-sh/ruff/pull/26523))

### LSP server

- Fix selection range behavior for strings ([#26532](https://github.com/astral-sh/ruff/pull/26532))
- Recognize that dedent ends doctest block when parsing docstrings for signature help ([#26552](https://github.com/astral-sh/ruff/pull/26552))
- Render reStructuredText hyperlinks as Markdown in hover docstrings ([#25907](https://github.com/astral-sh/ruff/pull/25907))
- Update `__slots__` string when renaming an attribute ([#26438](https://github.com/astral-sh/ruff/pull/26438))

### Documentation

- Document PYTHONPATH support in module discovery ([#3889](https://github.com/astral-sh/ty/pull/3889))

### Library support

- Add support for extra arguments in Pydantic model constructors ([#26520](https://github.com/astral-sh/ruff/pull/26520))
- Detect Pydantic model configurations ([#26573](https://github.com/astral-sh/ruff/pull/26573))
- Distinguish lax and strict mode for Pydantic models ([#26587](https://github.com/astral-sh/ruff/pull/26587))

### Core type checking

- Fix subtyping/assignability for `@property` protocol members ([#25332](https://github.com/astral-sh/ruff/pull/25332))
- Narrow `isinstance` against intersections containing invalid member ([#26545](https://github.com/astral-sh/ruff/pull/26545))
- Narrow match subjects through structural patterns ([#25942](https://github.com/astral-sh/ruff/pull/25942))
- Preserve generic `functools.partial` signatures ([#24583](https://github.com/astral-sh/ruff/pull/24583))
- Preserve generic variadic callback semantics ([#26521](https://github.com/astral-sh/ruff/pull/26521))
- Preserve invariant materialization on generic specializations ([#26578](https://github.com/astral-sh/ruff/pull/26578))
- Preserve literal enum member names ([#26592](https://github.com/astral-sh/ruff/pull/26592))

### Performance

- Avoid exponential invariant constraint paths ([#26538](https://github.com/astral-sh/ruff/pull/26538))
- Batch parallel jobs when finding references ([#26534](https://github.com/astral-sh/ruff/pull/26534))
- Build module names directly in `CompactString` ([#26546](https://github.com/astral-sh/ruff/pull/26546))
- Elide default use-def state ([#26398](https://github.com/astral-sh/ruff/pull/26398))
- Reuse owned buffers for string literals ([#26547](https://github.com/astral-sh/ruff/pull/26547))
- Use ICF for macOS release builds ([#3709](https://github.com/astral-sh/ty/pull/3709))
- Use cached class literal lookup for `is_subclass_of` ([#26585](https://github.com/astral-sh/ruff/pull/26585))

### Contributors

- [@sharkdp](https://github.com/sharkdp)
- [@fenghourun](https://github.com/fenghourun)
- [@zaniebot](https://github.com/zaniebot)
- [@charliermarsh](https://github.com/charliermarsh)
- [@MichaReiser](https://github.com/MichaReiser)
- [@shaanmajid](https://github.com/shaanmajid)
- [@jvdillon](https://github.com/jvdillon)
- [@sqqueak](https://github.com/sqqueak)
- [@SuryanshSS1011](https://github.com/SuryanshSS1011)
- [@carljm](https://github.com/carljm)
- [@lerebear](https://github.com/lerebear)

## 0.0.56

Released on 2026-07-01.

### Bug fixes

- Avoid MRO cycle when collecting NamedTuple fields ([#26464](https://github.com/astral-sh/ruff/pull/26464))
- Model `int` and `str` enum value normalization ([#26349](https://github.com/astral-sh/ruff/pull/26349))
- Prefer reflected operators by runtime class ([#26434](https://github.com/astral-sh/ruff/pull/26434), [#26474](https://github.com/astral-sh/ruff/pull/26474))

### CLI

- Exit with status 130 when interrupted ([#26465](https://github.com/astral-sh/ruff/pull/26465))

### Performance

- Avoid exponential OR-pattern reachability ([#26481](https://github.com/astral-sh/ruff/pull/26481))
- Reduce bound typevar identity overhead ([#26396](https://github.com/astral-sh/ruff/pull/26396))

### Core type checking

- Infer generic class pattern capture types ([#26479](https://github.com/astral-sh/ruff/pull/26479))
- Narrow exact tuples through sequence patterns ([#26424](https://github.com/astral-sh/ruff/pull/26424))
- Recognize inherited enum member constructors ([#26410](https://github.com/astral-sh/ruff/pull/26410))
- Respect return-context inference when filtering overloads ([#26454](https://github.com/astral-sh/ruff/pull/26454))
- Sync vendored typeshed stubs ([#26501](https://github.com/astral-sh/ruff/pull/26501)). [Typeshed diff](https://github.com/python/typeshed/compare/3c6221722aac5bd9dbfc5fbf7b4f0bf64b2c5724...b9090e99745ac1511d8efd828622b11a9a3623e8)

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.55

Released on 2026-06-26.

### LSP server

- Render full diagnostics in color ([#26384](https://github.com/astral-sh/ruff/pull/26384))

### Documentation

- Document colored diagnostic output ([#3858](https://github.com/astral-sh/ty/pull/3858))

### Performance

- Improve vendored filesystem concurrency ([#26408](https://github.com/astral-sh/ruff/pull/26408))
- Optimize enum comparisons in equality evaluation ([#26340](https://github.com/astral-sh/ruff/pull/26340))
- Remove redundant semantic index shrinks ([#26392](https://github.com/astral-sh/ruff/pull/26392))
- Use never-change durability for one-shot checks ([#26359](https://github.com/astral-sh/ruff/pull/26359))

### Core type checking

- Correct enum alias detection and scalar constructors ([#26345](https://github.com/astral-sh/ruff/pull/26345))
- Fix structural pattern binding inference ([#26411](https://github.com/astral-sh/ruff/pull/26411))
- Improve variable-length tuple slicing ([#26151](https://github.com/astral-sh/ruff/pull/26151))
- Infer class and mapping pattern bindings ([#25941](https://github.com/astral-sh/ruff/pull/25941))
- Infer empty collection constructors from later uses ([#26389](https://github.com/astral-sh/ruff/pull/26389))
- Skip shadowed submodule bindings during import analysis ([#26385](https://github.com/astral-sh/ruff/pull/26385))
- Sync vendored typeshed stubs ([#26406](https://github.com/astral-sh/ruff/pull/26406)). [Typeshed diff](https://github.com/python/typeshed/compare/8e6a886ca5b14742924be721d345a619762d6e93...3c6221722aac5bd9dbfc5fbf7b4f0bf64b2c5724)
- Track literal iterable emptiness for reachability ([#25222](https://github.com/astral-sh/ruff/pull/25222))
- Validate positional class patterns against `__match_args__` ([#26195](https://github.com/astral-sh/ruff/pull/26195))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@carljm](https://github.com/carljm)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@MichaReiser](https://github.com/MichaReiser)
- [@mtshiba](https://github.com/mtshiba)
- [@felixscherz](https://github.com/felixscherz)

## 0.0.54

Released on 2026-06-25.

### Bug fixes

- Avoid duplicate configuration error output ([#26375](https://github.com/astral-sh/ruff/pull/26375))
- Avoid stack overflows in reachability analysis ([#26272](https://github.com/astral-sh/ruff/pull/26272))
- Fix divergent recursive tuple cycle handling in ty ([#26316](https://github.com/astral-sh/ruff/pull/26316))
- Fix panic from relation queries during cycle recovery ([#26335](https://github.com/astral-sh/ruff/pull/26335))
- Fix panics by reverting recursive `TypeOf` cycle recovery ([#26339](https://github.com/astral-sh/ruff/pull/26339))
- Support basic usages of `__class__` closure cells in methods ([#26329](https://github.com/astral-sh/ruff/pull/26329))

### LSP server

- Fix typealias token classification inconsistency ([#26255](https://github.com/astral-sh/ruff/pull/26255))
- Implement rust-analyzer's "Click for full compiler diagnostic" feature ([#26269](https://github.com/astral-sh/ruff/pull/26269))

### Performance

- Co-locate retained definition usage state ([#26019](https://github.com/astral-sh/ruff/pull/26019))
- Use never-change durability for immutable file inputs ([#26353](https://github.com/astral-sh/ruff/pull/26353))

### Diagnostics

- Reject undeclared protocol instance attributes ([#26336](https://github.com/astral-sh/ruff/pull/26336))

### Core type checking

- Allow replacing ordinary methods with compatible functions ([#26158](https://github.com/astral-sh/ruff/pull/26158))
- Distinguish `typing.TypedDict` from `typing_extensions.TypedDict` ([#25843](https://github.com/astral-sh/ruff/pull/25843))
- Don't treat non-empty ranges as single-valued ([#26351](https://github.com/astral-sh/ruff/pull/26351))
- Handle TypeVar bounds over `type[...]` in attribute lookup ([#26146](https://github.com/astral-sh/ruff/pull/26146))
- Infer definite equality comparison results ([#26337](https://github.com/astral-sh/ruff/pull/26337))
- Infer mismatched literal comparisons ([#26313](https://github.com/astral-sh/ruff/pull/26313))
- `match` statements: make class-pattern fallthrough member-aware ([#26283](https://github.com/astral-sh/ruff/pull/26283))
- `match` statements: prove TypedDict structural patterns exhaustive ([#26285](https://github.com/astral-sh/ruff/pull/26285))
- `match` statements: resolve positional class-pattern exhaustiveness ([#26284](https://github.com/astral-sh/ruff/pull/26284))
- Model non-exhaustive enum member sets (`enum.Flag`s) ([#26277](https://github.com/astral-sh/ruff/pull/26277))
- Reduce retained definition map storage ([#26348](https://github.com/astral-sh/ruff/pull/26348))
- Reuse equality semantics for membership compatibility ([#25955](https://github.com/astral-sh/ruff/pull/25955))
- Sync vendored typeshed stubs to support `builtins.sentinel` ([#26341](https://github.com/astral-sh/ruff/pull/26341))
- Treat non-empty `range` calls as non-empty for reachability ([#25220](https://github.com/astral-sh/ruff/pull/25220))
- Use assignability for divergent constraints ([#26334](https://github.com/astral-sh/ruff/pull/26334))
- Widen inferred class-valued instance attributes ([#26338](https://github.com/astral-sh/ruff/pull/26338))

### Contributors

- [@carljm](https://github.com/carljm)
- [@sqqueak](https://github.com/sqqueak)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@mtshiba](https://github.com/mtshiba)
- [@charliermarsh](https://github.com/charliermarsh)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.53

Released on 2026-06-23.

### Bug fixes

- Avoid bypassing lazy constraints for `Divergent` ([#26288](https://github.com/astral-sh/ruff/pull/26288))
- Avoid recursion when projecting narrowing constraints ([#26276](https://github.com/astral-sh/ruff/pull/26276))
- Fix ParamSpec callable signature extraction for callable instances ([#26279](https://github.com/astral-sh/ruff/pull/26279))
- Make multi-arm `TypeOf` cycle recovery monotonic ([#26275](https://github.com/astral-sh/ruff/pull/26275))

### LSP server

- Document all special forms in `ty_extensions` ([#26263](https://github.com/astral-sh/ruff/pull/26263))

### Performance

- Avoid cloning fallback condition flow snapshots ([#26203](https://github.com/astral-sh/ruff/pull/26203))
- Avoid constructing discarded speculative diagnostics ([#26251](https://github.com/astral-sh/ruff/pull/26251))
- Avoid path lookups when sorting same-file diagnostics ([#26257](https://github.com/astral-sh/ruff/pull/26257))
- Cache `is_never_satisfied` results ([#26261](https://github.com/astral-sh/ruff/pull/26261))
- Defer applying type context to simple standalone expressions ([#26252](https://github.com/astral-sh/ruff/pull/26252))

### Core type checking

- Infer types for names bound in match patterns ([#25940](https://github.com/astral-sh/ruff/pull/25940))
- Preserve regular kind for callable instances ([#26253](https://github.com/astral-sh/ruff/pull/26253))
- Simplify intersections of invariant generic types with `Any` specializations ([#26127](https://github.com/astral-sh/ruff/pull/26127))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@MichaReiser](https://github.com/MichaReiser)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@sharkdp](https://github.com/sharkdp)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@carljm](https://github.com/carljm)

## 0.0.52

Released on 2026-06-22.

### Bug fixes

- Avoid shadowing hints for attribute assignments ([#26164](https://github.com/astral-sh/ruff/pull/26164))
- Fix dict.pop overloads to accept arbitrary keys with defaults ([#26241](https://github.com/astral-sh/ruff/pull/26241))
- Normalize recursive `TypeOf` across multiple union arms ([#26230](https://github.com/astral-sh/ruff/pull/26230))
- Normalize recursive `TypeOf` growth during cycle recovery ([#26163](https://github.com/astral-sh/ruff/pull/26163))
- Normalize recursive protocol growth during cycle recovery ([#26246](https://github.com/astral-sh/ruff/pull/26246))
- Preserve generic alias identity during cycle recovery ([#26166](https://github.com/astral-sh/ruff/pull/26166))
- Recover from dynamic class code generator cycles ([#26167](https://github.com/astral-sh/ruff/pull/26167))

### LSP server

- Add a go-to destination for `Divergent` ([#26162](https://github.com/astral-sh/ruff/pull/26162))
- Publish diagnostics for all open files after a single file is saved ([#25929](https://github.com/astral-sh/ruff/pull/25929))
- Render Markdown for reStructuredText fields in docstrings on hover ([#25903](https://github.com/astral-sh/ruff/pull/25903))

### CLI

- Make `error-on-warning` the default ([#26157](https://github.com/astral-sh/ruff/pull/26157))

### Diagnostics

- Make rendering of fix diffs more concise ([#26161](https://github.com/astral-sh/ruff/pull/26161))

### Performance

- Avoid allocating disabled error context trees ([#26191](https://github.com/astral-sh/ruff/pull/26191))
- Avoid lookup maps for small place tables ([#26177](https://github.com/astral-sh/ruff/pull/26177))
- Avoid moving boxed use-def map builders ([#26211](https://github.com/astral-sh/ruff/pull/26211))
- Avoid transient AST ID merge map ([#26185](https://github.com/astral-sh/ruff/pull/26185))
- Batch signature typevar freshness scans ([#26196](https://github.com/astral-sh/ruff/pull/26196))
- Box large semantic index builders ([#26186](https://github.com/astral-sh/ruff/pull/26186))
- Build frozen definition maps directly ([#26188](https://github.com/astral-sh/ruff/pull/26188))
- Compact use-def binding interner keys ([#26193](https://github.com/astral-sh/ruff/pull/26193))
- Consume condition flow snapshots ([#26189](https://github.com/astral-sh/ruff/pull/26189))
- Lazily allocate reachability caches ([#26194](https://github.com/astral-sh/ruff/pull/26194))
- Remove redundant use-def state shrinking ([#26206](https://github.com/astral-sh/ruff/pull/26206))
- Reuse the first union bindings buffer ([#26225](https://github.com/astral-sh/ruff/pull/26225))
- Short-circuit terminal narrowing constraints ([#26215](https://github.com/astral-sh/ruff/pull/26215))
- Solve simple constraint conjunctions directly ([#25879](https://github.com/astral-sh/ruff/pull/25879))
- Store cycle-detector cache entries inline ([#26183](https://github.com/astral-sh/ruff/pull/26183))
- Stream indexed AST construction ([#26184](https://github.com/astral-sh/ruff/pull/26184))
- Suppress discarded TypedDict diagnostics ([#26250](https://github.com/astral-sh/ruff/pull/26250))
- Use SmallVec for `CycleDetector::seen` ([#26181](https://github.com/astral-sh/ruff/pull/26181))
- Use a SmallVec for seen type aliases ([#26187](https://github.com/astral-sh/ruff/pull/26187))

### Core type checking

- Raise limit for number of non-recursive union literals ([#25212](https://github.com/astral-sh/ruff/pull/25212))
- Preserve gradual behavior for explicit Any subclasses ([#26034](https://github.com/astral-sh/ruff/pull/26034))
- Preserve metaclasses when inheriting from intersection-typed bases ([#26145](https://github.com/astral-sh/ruff/pull/26145))
- Recognize exhaustive matches over finite tuples ([#26132](https://github.com/astral-sh/ruff/pull/26132))

### Contributors

- [@JamBalaya56562](https://github.com/JamBalaya56562)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@carljm](https://github.com/carljm)
- [@Minibrams](https://github.com/Minibrams)
- [@lerebear](https://github.com/lerebear)
- [@MichaReiser](https://github.com/MichaReiser)
- [@charliermarsh](https://github.com/charliermarsh)

## 0.0.51

Released on 2026-06-18.

### Bug fixes

- Fix bound TypeVar default cycle recovery ([#26124](https://github.com/astral-sh/ruff/pull/26124))
- Support `Annotated[Any, ...]` as a class base ([#26133](https://github.com/astral-sh/ruff/pull/26133))

### LSP server

- Suggest keyword-only arguments between variadic parameters ([#26134](https://github.com/astral-sh/ruff/pull/26134))

### Core type checking

- Avoid assuming classes with `Any` or `Unknown` bases are descriptors ([#26120](https://github.com/astral-sh/ruff/pull/26120))
- Infer simpler types in complex lambda cycles ([#26137](https://github.com/astral-sh/ruff/pull/26137))
- Preserve exact class objects during identity narrowing ([#26117](https://github.com/astral-sh/ruff/pull/26117))

### Diagnostics

- Preserve unpacking diagnostics for nested assignment targets ([#26121](https://github.com/astral-sh/ruff/pull/26121))

### Performance

- Compact indexed AST node storage ([#25998](https://github.com/astral-sh/ruff/pull/25998))
- Discard dead DNF branches in intersection building ([#26144](https://github.com/astral-sh/ruff/pull/26144))

### Documentation

- Remove broken gradual guarantee link ([#3806](https://github.com/astral-sh/ty/pull/3806))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@carljm](https://github.com/carljm)
- [@MichaReiser](https://github.com/MichaReiser)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.50

Released on 2026-06-17.

### Bug fixes

- Avoid cross-TypeVar leakage in generic inference ([#26099](https://github.com/astral-sh/ruff/pull/26099))
- Fix panic from oscillating collection-use constraints ([#26031](https://github.com/astral-sh/ruff/pull/26031))
- Preserve type variables in fixed tuple aliases ([#26041](https://github.com/astral-sh/ruff/pull/26041))
- Respect ParamSpec binding contexts ([#25993](https://github.com/astral-sh/ruff/pull/25993))
- Show bare `Final` as a special form on hover ([#26029](https://github.com/astral-sh/ruff/pull/26029))
- Support options in functional dataclass calls ([#25989](https://github.com/astral-sh/ruff/pull/25989))

### LSP server

- Add context-sensitive keyword completions ([#26036](https://github.com/astral-sh/ruff/pull/26036))
- Fix wildcard import symbol range ([#25740](https://github.com/astral-sh/ruff/pull/25740))
- Highlight decorated methods consistently ([#26003](https://github.com/astral-sh/ruff/pull/26003))
- Preserve narrowing after qualified `TYPE_CHECKING` ([#26051](https://github.com/astral-sh/ruff/pull/26051))
- Respect client's content format preference ([#25957](https://github.com/astral-sh/ruff/pull/25957))
- Retain all diagnostic annotations in the server ([#26006](https://github.com/astral-sh/ruff/pull/26006))
- Track unused-binding captures across nested scopes ([#25536](https://github.com/astral-sh/ruff/pull/25536))

### Diagnostics

- Fix override diagnostics for decorated methods ([#25671](https://github.com/astral-sh/ruff/pull/25671))
- Improve `duplicate-base` diagnostics ([#26107](https://github.com/astral-sh/ruff/pull/26107))
- Reject invalid dataclass flag combinations ([#25985](https://github.com/astral-sh/ruff/pull/25985))
- Reject legacy TypeVars in PEP 695 class bases ([#25975](https://github.com/astral-sh/ruff/pull/25975))
- Reject legacy TypeVars in PEP 695 functions ([#25979](https://github.com/astral-sh/ruff/pull/25979))
- Respect `@no_type_check` in function validation ([#25994](https://github.com/astral-sh/ruff/pull/25994))

### Performance

- Avoid rebuilding unchanged specializations ([#25826](https://github.com/astral-sh/ruff/pull/25826))
- Avoid redundant equality intersections ([#26057](https://github.com/astral-sh/ruff/pull/26057))
- Avoid retaining empty use-def tables ([#26018](https://github.com/astral-sh/ruff/pull/26018))
- Compact retained definition inference extras ([#25838](https://github.com/astral-sh/ruff/pull/25838))
- Deduplicate retained scope inference types ([#25846](https://github.com/astral-sh/ruff/pull/25846))
- Disable LRU tracking for one-shot checks ([#26106](https://github.com/astral-sh/ruff/pull/26106))
- Fast path collection literals with exact type contexts ([#25878](https://github.com/astral-sh/ruff/pull/25878))
- Flatten retained declaration states ([#25912](https://github.com/astral-sh/ruff/pull/25912))
- Improve flow snapshot performance ([#26012](https://github.com/astral-sh/ruff/pull/26012))
- Skip stub package checks in stub-free search paths ([#25963](https://github.com/astral-sh/ruff/pull/25963))
- Speed up large-union narrowing ([#26048](https://github.com/astral-sh/ruff/pull/26048))
- Speed up module resolution for projects with many search paths ([#25962](https://github.com/astral-sh/ruff/pull/25962))
- Store cumulative binding end offsets ([#25913](https://github.com/astral-sh/ruff/pull/25913))
- Use compact frozen representation for narrowing constraints ([#25990](https://github.com/astral-sh/ruff/pull/25990))

### Core type checking

- Annotate intersection and negation types using `&` and `~` ([#26035](https://github.com/astral-sh/ruff/pull/26035))
- Diagnose zero-step slices on lists ([#25966](https://github.com/astral-sh/ruff/pull/25966))
- Full-scope bidirectional inference for non-empty collection literals ([#25280](https://github.com/astral-sh/ruff/pull/25280))
- Improve equality-based narrowing for `==`, `!=`, and `match` ([#25788](https://github.com/astral-sh/ruff/pull/25788))
- Infer precise values for standard-library enums ([#26103](https://github.com/astral-sh/ruff/pull/26103))
- Make equality evaluation cycle-aware ([#26055](https://github.com/astral-sh/ruff/pull/26055))
- Narrow equality across IntEnum classes ([#26079](https://github.com/astral-sh/ruff/pull/26079))
- Narrow tuple expression match subjects ([#25874](https://github.com/astral-sh/ruff/pull/25874))
- Preserve literal types for loop variables over literal collections ([#25083](https://github.com/astral-sh/ruff/pull/25083))
- Preserve negative narrowing for starred sequence patterns ([#25927](https://github.com/astral-sh/ruff/pull/25927))
- Preserve non-final types in Hashable unions ([#26039](https://github.com/astral-sh/ruff/pull/26039))
- Support enum literals as tagged-union discriminants ([#25855](https://github.com/astral-sh/ruff/pull/25855))
- Sync vendored typeshed stubs ([#25952](https://github.com/astral-sh/ruff/pull/25952)). [Typeshed diff](https://github.com/python/typeshed/compare/32b95c1f59aa2c8edd7f2a5fd3bdfeed639ee1a7...feeb9aa8dde3ae9269b13f3bae435b82d8538b76)
- Sync vendored typeshed stubs ([#25997](https://github.com/astral-sh/ruff/pull/25997)). [Typeshed diff](https://github.com/python/typeshed/compare/32b95c1f59aa2c8edd7f2a5fd3bdfeed639ee1a7...feeb9aa8dde3ae9269b13f3bae435b82d8538b76)
- Synthesize NamedTuple `__match_args__` ([#25934](https://github.com/astral-sh/ruff/pull/25934))
- Treat assigned enum hooks conservatively ([#25958](https://github.com/astral-sh/ruff/pull/25958))
- Validate deprecated warning categories ([#26025](https://github.com/astral-sh/ruff/pull/26025))

### Contributors

- [@AlexWaygood](https://github.com/AlexWaygood)
- [@MichaReiser](https://github.com/MichaReiser)
- [@ankddev](https://github.com/ankddev)
- [@sqqueak](https://github.com/sqqueak)
- [@lerebear](https://github.com/lerebear)
- [@sharkdp](https://github.com/sharkdp)
- [@denyszhak](https://github.com/denyszhak)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@charliermarsh](https://github.com/charliermarsh)

## 0.0.49

Released on 2026-06-11.

### Bug fixes

- Fix site-package error when multiple versions of Python are installed in system path ([#25769](https://github.com/astral-sh/ruff/pull/25769))

### Diagnostics

- Point at attribute's binding site in \`invalid-await diagnostic ([#24628](https://github.com/astral-sh/ruff/pull/24628))
- Report redefined legacy TypeVars ([#25854](https://github.com/astral-sh/ruff/pull/25854))

### Performance

- Add dedicated TDDs for narrowing constraints ([#25834](https://github.com/astral-sh/ruff/pull/25834))
- Avoid caching same-file raw signatures ([#25761](https://github.com/astral-sh/ruff/pull/25761))
- Cache reachability evaluations during inference ([#25696](https://github.com/astral-sh/ruff/pull/25696))
- Compact retained definition maps ([#25737](https://github.com/astral-sh/ruff/pull/25737))
- Omit redundant definition inference owner keys ([#25837](https://github.com/astral-sh/ruff/pull/25837))

### Core type checking

- Preserve nominal type of `enum.property` instances ([#25849](https://github.com/astral-sh/ruff/pull/25849))
- Restrict length narrowing to types that encode their length ([#25840](https://github.com/astral-sh/ruff/pull/25840))
- Use peer context for collection literals ([#25848](https://github.com/astral-sh/ruff/pull/25848))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@anishgirianish](https://github.com/anishgirianish)
- [@cheparity](https://github.com/cheparity)
- [@carljm](https://github.com/carljm)

## 0.0.48

Released on 2026-06-10.

### Performance

- Avoid redundant constraint saturation work ([#25786](https://github.com/astral-sh/ruff/pull/25786))

### Core type checking

- Add support for TypedDict `extra_items` ([#25591](https://github.com/astral-sh/ruff/pull/25591))
- Improve `closed=True` TypedDict precision ([#25651](https://github.com/astral-sh/ruff/pull/25651))
- Require subtyping for transitive constraint pivots ([#25778](https://github.com/astral-sh/ruff/pull/25778))
- Sync vendored typeshed stubs ([#25828](https://github.com/astral-sh/ruff/pull/25828)). [Typeshed diff](https://github.com/python/typeshed/compare/d3504ddc24c92b960a9661813efcdef10fad6d29...32b95c1f59aa2c8edd7f2a5fd3bdfeed639ee1a7)

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.47

Released on 2026-06-10.

### Bug fixes

- Avoid panicking on encountering a recursive NamedTuple that references a recursive NewType ([#25764](https://github.com/astral-sh/ruff/pull/25764))
- Fix out-of-bound panic in notebooks involving suppression comments ([#25629](https://github.com/astral-sh/ruff/pull/25629))

### Core type checking

- Preserve overloads through callable protocol decorators ([#25806](https://github.com/astral-sh/ruff/pull/25806))
- Sync vendored typeshed stubs ([#25779](https://github.com/astral-sh/ruff/pull/25779)). [Typeshed diff](https://github.com/python/typeshed/compare/4a47505dd891ac8a94ba7f4b578899c72727ce23...d3504ddc24c92b960a9661813efcdef10fad6d29)

### Performance and memory-usage improvements

- Avoid caching specialization-invariant known instances ([#25816](https://github.com/astral-sh/ruff/pull/25816))
- Avoid resolving overload sets for ordinary functions ([#25817](https://github.com/astral-sh/ruff/pull/25817))
- Store common definition inference results inline ([#25814](https://github.com/astral-sh/ruff/pull/25814))
- Use `Box<SystemPath>` etc. in `Files` ([#25554](https://github.com/astral-sh/ruff/pull/25554))

### Contributors

- [@dhruvmanila](https://github.com/dhruvmanila)
- [@MichaReiser](https://github.com/MichaReiser)
- [@charliermarsh](https://github.com/charliermarsh)

## 0.0.46

Released on 2026-06-08.

### Bug fixes

- Avoid crash when hovering over Callable ([#25759](https://github.com/astral-sh/ruff/pull/25759))

### Core type checking

- Support `Callable()` in match statement class patterns ([#25541](https://github.com/astral-sh/ruff/pull/25541))
- Improve support for `enum.property` ([#25681](https://github.com/astral-sh/ruff/pull/25681))

### Contributors

- [@carljm](https://github.com/carljm)
- [@charliermarsh](https://github.com/charliermarsh)
- [@thejchap](https://github.com/thejchap)

## 0.0.45

Released on 2026-06-08.

### Bug fixes

- Avoid treating dynamic class attributes as instance attributes ([#25678](https://github.com/astral-sh/ruff/pull/25678))
- Fix divergence in recursive inference due to ambiguous overload ([#25548](https://github.com/astral-sh/ruff/pull/25548))
- Preserve literal promotion for mixed bounds ([#25648](https://github.com/astral-sh/ruff/pull/25648))

### Diagnostics

- Add `missing-type-argument` lint rule ([#25617](https://github.com/astral-sh/ruff/pull/25617))

### Core type checking

- Add support for narrowing on tuple match cases ([#25493](https://github.com/astral-sh/ruff/pull/25493))
- Check implicit open TypedDict extra items ([#25628](https://github.com/astral-sh/ruff/pull/25628))
- Create fresh copies of generic callable typevars ([#24949](https://github.com/astral-sh/ruff/pull/24949))
- Preserve deprecation on replacement functions ([#25688](https://github.com/astral-sh/ruff/pull/25688))
- Preserve intersection receivers during attribute lookup ([#25626](https://github.com/astral-sh/ruff/pull/25626))
- Preserve transparent callable decorators ([#25030](https://github.com/astral-sh/ruff/pull/25030))

### Performance

- Avoid AST load for callable description names ([#25728](https://github.com/astral-sh/ruff/pull/25728))
- Avoid caching absent class decorators and type parameters ([#25689](https://github.com/astral-sh/ruff/pull/25689))
- Avoid caching atomic type specializations ([#25663](https://github.com/astral-sh/ruff/pull/25663))
- Avoid caching constant constraint relations ([#25656](https://github.com/astral-sh/ruff/pull/25656))
- Avoid caching missing implicit attributes ([#25649](https://github.com/astral-sh/ruff/pull/25649))
- Avoid caching trivial class-header queries ([#25692](https://github.com/astral-sh/ruff/pull/25692))
- Avoid caching trivial member lookups ([#25661](https://github.com/astral-sh/ruff/pull/25661))
- Bypass member lookup for module imports ([#25723](https://github.com/astral-sh/ruff/pull/25723))
- Cache constraint implication checks ([#25714](https://github.com/astral-sh/ruff/pull/25714))
- Cache upper-bound satisfiability ([#25710](https://github.com/astral-sh/ruff/pull/25710))
- Compact retained function type signatures ([#25669](https://github.com/astral-sh/ruff/pull/25669))
- Compact retained use-def bindings ([#25682](https://github.com/astral-sh/ruff/pull/25682))
- Consolidate retained narrowing constraints ([#25660](https://github.com/astral-sh/ruff/pull/25660))
- Construct trivial constraint sets directly ([#25659](https://github.com/astral-sh/ruff/pull/25659))
- Resolve function descriptors directly ([#25675](https://github.com/astral-sh/ruff/pull/25675))
- Share code-generator classification across specializations ([#25701](https://github.com/astral-sh/ruff/pull/25701))
- Share parameter lists with `Arc` ([#25735](https://github.com/astral-sh/ruff/pull/25735))
- Use same-file expression inference in reachability ([#25694](https://github.com/astral-sh/ruff/pull/25694))

### Contributors

- [@mtshiba](https://github.com/mtshiba)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@charliermarsh](https://github.com/charliermarsh)
- [@dcreager](https://github.com/dcreager)
- [@carljm](https://github.com/carljm)
- [@reginaldl](https://github.com/reginaldl)

## 0.0.44

Released on 2026-06-04.

### Bug fixes

- Avoid treating `sys.implementation.version` like `sys.version_info` ([#25608](https://github.com/astral-sh/ruff/pull/25608))
- Fix anchor point for override diagnostics ([#25621](https://github.com/astral-sh/ruff/pull/25621))

### LSP server

- Show type alias value on hover ([#25381](https://github.com/astral-sh/ruff/pull/25381))

### Performance

- Add caching for pattern match narrowing ([#25613](https://github.com/astral-sh/ruff/pull/25613))
- Compact retained definition and expression identities ([#25606](https://github.com/astral-sh/ruff/pull/25606))
- Reuse expression cache for TypedDict union inference ([#25643](https://github.com/astral-sh/ruff/pull/25643))
- Upgrade Salsa ([#25545](https://github.com/astral-sh/ruff/pull/25545))

### Core type checking

- Enable narrowing for unions of TypedDict ([#25188](https://github.com/astral-sh/ruff/pull/25188))

### Contributors

- [@lerebear](https://github.com/lerebear)
- [@MichaReiser](https://github.com/MichaReiser)
- [@carljm](https://github.com/carljm)
- [@pierrem964](https://github.com/pierrem964)
- [@charliermarsh](https://github.com/charliermarsh)
- [@Hugo-Polloli](https://github.com/Hugo-Polloli)

## 0.0.43

Released on 2026-06-03.

### Bug fixes

- Don't inject `Unknown` from non-callable elements of intersection call ([#25538](https://github.com/astral-sh/ruff/pull/25538))
- Don't needlessly disambiguate the same type alias ([#25563](https://github.com/astral-sh/ruff/pull/25563))
- Fix variance inference for nested type aliases ([#25567](https://github.com/astral-sh/ruff/pull/25567))
- Ignore rejected member annotations for synthesized bindings ([#25427](https://github.com/astral-sh/ruff/pull/25427))
- Normalize dynamic class literals in cycle recovery ([#25558](https://github.com/astral-sh/ruff/pull/25558))
- Register file roots for first-party search paths ([#25522](https://github.com/astral-sh/ruff/pull/25522))
- Treat union-bound typevars like unions for `possibly-missing-attribute` ([#25561](https://github.com/astral-sh/ruff/pull/25561))

### LSP server

- Suppress importable completions that are already in scope ([#25479](https://github.com/astral-sh/ruff/pull/25479))

### Performance

- Avoid retaining duplicate function signatures ([#25609](https://github.com/astral-sh/ruff/pull/25609))
- Compact retained definition inference results ([#25593](https://github.com/astral-sh/ruff/pull/25593))
- Compact retained definition kinds ([#25610](https://github.com/astral-sh/ruff/pull/25610))
- Compact retained definitions by node ([#25498](https://github.com/astral-sh/ruff/pull/25498))
- Consolidate AST ID reverse lookup ([#25455](https://github.com/astral-sh/ruff/pull/25455))
- Consolidate retained use-def definition maps ([#25499](https://github.com/astral-sh/ruff/pull/25499))
- Omit redundant definitions-by-node entries ([#25501](https://github.com/astral-sh/ruff/pull/25501))
- Reuse common protocol constraints for TypedDict unions ([#25598](https://github.com/astral-sh/ruff/pull/25598))

### Diagnostics

- Improve error context for not-iterable diagnostics ([#24944](https://github.com/astral-sh/ruff/pull/24944))

### Core type checking

- Detect disjointness due to incompatible generic specializations ([#24822](https://github.com/astral-sh/ruff/pull/24822))
- Distinguish `typing.Callable` from `collections.abc.Callable` ([#24954](https://github.com/astral-sh/ruff/pull/24954))
- Include nested `global`/`nonlocal` bindings in type inference ([#25387](https://github.com/astral-sh/ruff/pull/25387))
- Optional lower/upper bounds in individual constraints ([#25435](https://github.com/astral-sh/ruff/pull/25435))
- Preserve slice-bound types in subscript inference ([#25446](https://github.com/astral-sh/ruff/pull/25446))
- Reject `Self` in type aliases ([#25529](https://github.com/astral-sh/ruff/pull/25529))
- Require literal booleans for TypedDict flags ([#25594](https://github.com/astral-sh/ruff/pull/25594))
- Support narrowing on lengths ([#25347](https://github.com/astral-sh/ruff/pull/25347))
- Synthesize precise `__len__` methods for literals ([#25600](https://github.com/astral-sh/ruff/pull/25600))
- Use callable type context to implicitly specialize generic class ([#25471](https://github.com/astral-sh/ruff/pull/25471))
- expand type aliases inside type context unions ([#25553](https://github.com/astral-sh/ruff/pull/25553))

### Contributors

- [@carljm](https://github.com/carljm)
- [@cheparity](https://github.com/cheparity)
- [@kouhe3](https://github.com/kouhe3)
- [@sharkdp](https://github.com/sharkdp)
- [@charliermarsh](https://github.com/charliermarsh)
- [@dcreager](https://github.com/dcreager)
- [@thejchap](https://github.com/thejchap)
- [@oconnor663](https://github.com/oconnor663)

## 0.0.42

Released on 2026-06-01.

### Bug fixes

- Fix narrowing of enum literal unions by member identity ([#25520](https://github.com/astral-sh/ruff/pull/25520))
- Detect recursive expansion in constraint-set solving ([#25442](https://github.com/astral-sh/ruff/pull/25442))

### Core type checking

- Support tagged-union narrowing for nominal types ([#24916](https://github.com/astral-sh/ruff/pull/24916))
- Extend `Generator` assignability workaround to Python 3.13+ ([#25472](https://github.com/astral-sh/ruff/pull/25472))
- Sync vendored typeshed stubs ([#25514](https://github.com/astral-sh/ruff/pull/25514)). [Typeshed diff](https://github.com/python/typeshed/compare/e4d32e01bee44241a5e7c33298c261175b9f1bdb...4a47505dd891ac8a94ba7f4b578899c72727ce23)

### Performance

- Avoid redundant work for empty collection context ([#25527](https://github.com/astral-sh/ruff/pull/25527))
- Deduplicate retained use-def place states ([#25450](https://github.com/astral-sh/ruff/pull/25450))
- Compact retained semantic maps ([#25238](https://github.com/astral-sh/ruff/pull/25238))

### Contributors

- [@aholyoke](https://github.com/aholyoke)
- [@carljm](https://github.com/carljm)
- [@charliermarsh](https://github.com/charliermarsh)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.41

Released on 2026-05-31.

### Bug fixes

- Avoid panic for deferred dataclass field annotations ([#25444](https://github.com/astral-sh/ruff/pull/25444))
- Avoid panic from cycle in function decorator inference ([#25475](https://github.com/astral-sh/ruff/pull/25475))
- Ignore rejected assignments for synthesized bindings ([#25340](https://github.com/astral-sh/ruff/pull/25340))
- Infer `bool` for `not` applied to dynamic values ([#25445](https://github.com/astral-sh/ruff/pull/25445))
- Use diagnostic message as tie-breaker when sorting ([#25424](https://github.com/astral-sh/ruff/pull/25424))

### LSP server

- Add call hierarchy support ([#25338](https://github.com/astral-sh/ruff/pull/25338))
- Add function parentheses completion ([#25305](https://github.com/astral-sh/ruff/pull/25305))
- Display docs for matching parameter when hovering over the name of an argument passed by keyword ([#25283](https://github.com/astral-sh/ruff/pull/25283))
- Document `completeFunctionParentheses` editor setting ([#3513](https://github.com/astral-sh/ty/pull/3513))

### Diagnostics

- Introduce opt-in `missing-override-decorator` rule ([#25111](https://github.com/astral-sh/ruff/pull/25111))
- Improve diagnostics for syntax errors in forward annotations ([#25158](https://github.com/astral-sh/ruff/pull/25158))
- Improve diagnostic for failed assignment to a `Callable` type ([#25308](https://github.com/astral-sh/ruff/pull/25308))

### Core type checking

- Narrow bound method overloads by receiver ([#24707](https://github.com/astral-sh/ruff/pull/24707))
- Add disjointness for protocol method members ([#25315](https://github.com/astral-sh/ruff/pull/25315))
- Avoid treating metaclass declarations as populated values ([#25432](https://github.com/astral-sh/ruff/pull/25432))
- Use `TypeForm` in `ty_extensions` ([#25421](https://github.com/astral-sh/ruff/pull/25421))

### Performance

- Avoid storing redundant reachability indexes ([#25453](https://github.com/astral-sh/ruff/pull/25453))
- Compact retained semantic arrays ([#25454](https://github.com/astral-sh/ruff/pull/25454))
- Remove excess capacity from more Salsa cached collections ([#25411](https://github.com/astral-sh/ruff/pull/25411))
- Use compact sets for more immutable fields ([#25476](https://github.com/astral-sh/ruff/pull/25476))
- Use ThinVec for sparse kwargs bindings ([#25457](https://github.com/astral-sh/ruff/pull/25457))

### Contributors

- [@sharkdp](https://github.com/sharkdp)
- [@charliermarsh](https://github.com/charliermarsh)
- [@lerebear](https://github.com/lerebear)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@MichaReiser](https://github.com/MichaReiser)
- [@mhuen](https://github.com/mhuen)
- [@jelle-openai](https://github.com/jelle-openai)

## 0.0.40

Released on 2026-05-27.

### Bug fixes

- Accept complete enum-literal alias unions as enums ([#25341](https://github.com/astral-sh/ruff/pull/25341))
- Fix diagnostics in ignored folders after adding new files ([#25236](https://github.com/astral-sh/ruff/pull/25236))
- Show `LiteralString` when hovering over an inline of a literal string in an IDE ([#25373](https://github.com/astral-sh/ruff/pull/25373))

### LSP server

- Follow aliases when attempting to map a definition in a stub file to its "real" runtime definition ([#25328](https://github.com/astral-sh/ruff/pull/25328))
- Treat Python notebook text documents as Python sources ([#25393](https://github.com/astral-sh/ruff/pull/25393))
- Fix autocompletion for elements inside incomplete list comprehensions ([#25326](https://github.com/astral-sh/ruff/pull/25326))

### Diagnostics

- Add a subdiagnostic help message to `invalid-generic-class` diagnostics regarding incompatible variance ([#25385](https://github.com/astral-sh/ruff/pull/25385))

### Core type checking

- Ignore and reject annotations on non-name targets ([#25324](https://github.com/astral-sh/ruff/pull/25324))
- Infer class attributes assigned by metaclass initialization ([#25342](https://github.com/astral-sh/ruff/pull/25342))
- Reject inconsistent generic bases in "dynamic" classes created using `type(...)`, `types.new_type(...)`, etc. ([#25413](https://github.com/astral-sh/ruff/pull/25413))
- Resolve enum names for all unions arms in `Literal` enum subsets ([#25379](https://github.com/astral-sh/ruff/pull/25379))
- Support `typing.TypeForm` ([#25334](https://github.com/astral-sh/ruff/pull/25334))
- Fix many issues in the generics solver by using constraint sets more widely to solve type variables ([#24540](https://github.com/astral-sh/ruff/pull/24540))

### Contributors

- [@anuraaga](https://github.com/anuraaga)
- [@dcreager](https://github.com/dcreager)
- [@charliermarsh](https://github.com/charliermarsh)
- [@MichaReiser](https://github.com/MichaReiser)
- [@Dev-X25874](https://github.com/Dev-X25874)

## 0.0.39

Released on 2026-05-22.

This release removes the Python 3.9 branches from our vendored standard library stubs. ty now only has "full" support for
Python 3.10 and later, but will still report version-specific syntax errors and other diagnostics when `--python-version 3.9`
is provided via the CLI.

### Bug fixes

- Avoid panicking on `__new__` assignments to classes ([#25282](https://github.com/astral-sh/ruff/pull/25282))
- Preserve declaration order when synthesizing class fields ([#25249](https://github.com/astral-sh/ruff/pull/25249))
- Respect `dict`-compatible fallbacks in TypedDict unions ([#25242](https://github.com/astral-sh/ruff/pull/25242))
- Retain recursively-defined state in binary expressions ([#25277](https://github.com/astral-sh/ruff/pull/25277))

### LSP server

- Add Quick Fix to remove redundant cast ([#25211](https://github.com/astral-sh/ruff/pull/25211))
- Classify property declaration semantic tokens ([#25322](https://github.com/astral-sh/ruff/pull/25322))
- Escape HTML syntax in docstring rendering ([#25247](https://github.com/astral-sh/ruff/pull/25247))
- Prefer symbols from standard library over those of the same name from third party libraries for import completions. ([#25108](https://github.com/astral-sh/ruff/pull/25108))
- Support type aliases in document symbols ([#25302](https://github.com/astral-sh/ruff/pull/25302))

### Diagnostics

- Add error context for extra callable parameters ([#25269](https://github.com/astral-sh/ruff/pull/25269))

### Performance

- Avoid exponential blow-up in fall-through narrowing ([#25278](https://github.com/astral-sh/ruff/pull/25278))
- Speed up include filtering for projects with many literal include patterns ([#25266](https://github.com/astral-sh/ruff/pull/25266))

### Core type checking

- Allow enum member accesses on `self` ([#25077](https://github.com/astral-sh/ruff/pull/25077))
- Emit a diagnostic for subclassing with `order=True` ([#21704](https://github.com/astral-sh/ruff/pull/21704))
- Full-scope bidirectional inference for unconstrained container literals ([#25279](https://github.com/astral-sh/ruff/pull/25279))
- Infer `dict(TypedDict)` as `dict[str, object]` ([#24852](https://github.com/astral-sh/ruff/pull/24852))
- Refine Callable class-decorator fallback for unknown results ([#25250](https://github.com/astral-sh/ruff/pull/25250))
- Reject incompatible explicit variance in generic base classes ([#25327](https://github.com/astral-sh/ruff/pull/25327))
- Support multi-inference through type aliases ([#25245](https://github.com/astral-sh/ruff/pull/25245))
- Sync vendored typeshed stubs ([#25271](https://github.com/astral-sh/ruff/pull/25271), [#25172](https://github.com/astral-sh/ruff/pull/25172)). [Typeshed diff](https://github.com/python/typeshed/compare/e4d32e01bee44241a5e7c33298c261175b9f1bdb...4a47505dd891ac8a94ba7f4b578899c72727ce23)

### Contributors

- [@ibraheemdev](https://github.com/ibraheemdev)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@sqqueak](https://github.com/sqqueak)
- [@lerebear](https://github.com/lerebear)
- [@sharkdp](https://github.com/sharkdp)
- [@dhimasardinata](https://github.com/dhimasardinata)
- [@MichaReiser](https://github.com/MichaReiser)
- [@charliermarsh](https://github.com/charliermarsh)

## 0.0.38

Released on 2026-05-19.

### Bug fixes

- Fix panic in enum literal during cycle recovery ([#25237](https://github.com/astral-sh/ruff/pull/25237))
- Fix panic from lazy `NewType` base expansion during cycle recovery ([#25234](https://github.com/astral-sh/ruff/pull/25234))
- Fix class-body global lookup before class binding ([#25224](https://github.com/astral-sh/ruff/pull/25224))
- Handle aliased dict fallbacks in TypedDict unions ([#25241](https://github.com/astral-sh/ruff/pull/25241))
- Ignore `_generate_next_value_` with custom construction hooks ([#25210](https://github.com/astral-sh/ruff/pull/25210))

### LSP server

- Fix find references for `except` handlers ([#25231](https://github.com/astral-sh/ruff/pull/25231))
- Preserve delimiters when folding expressions ([#24999](https://github.com/astral-sh/ruff/pull/24999))
- Use incremental file walk on `.gitignore` changes ([#25183](https://github.com/astral-sh/ruff/pull/25183))

### Core type checking

- Add first-class support for enum complements ([#24961](https://github.com/astral-sh/ruff/pull/24961))
- Allow known non-field writes on frozen dataclass subclasses ([#25087](https://github.com/astral-sh/ruff/pull/25087))
- Ignore generic specialization in layout compatibility checks ([#25178](https://github.com/astral-sh/ruff/pull/25178))
- Preserve short-circuit bindings in all condition consumers ([#25160](https://github.com/astral-sh/ruff/pull/25160))
- Support class decorators ([#25091](https://github.com/astral-sh/ruff/pull/25091))
- Support custom `_generate_next_value_` methods in enums ([#25196](https://github.com/astral-sh/ruff/pull/25196))

### Contributors

- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@MichaReiser](https://github.com/MichaReiser)
- [@charliermarsh](https://github.com/charliermarsh)
- [@lerebear](https://github.com/lerebear)
- [@thejchap](https://github.com/thejchap)

## 0.0.37

Released on 2026-05-16.

### Bug fixes

- Avoid unsound `not in` narrowing ([#25161](https://github.com/astral-sh/ruff/pull/25161))
- Fix async iteration over narrowed typevars ([#25155](https://github.com/astral-sh/ruff/pull/25155))
- Fix panic in double-inference for single starred positional TypedDict ([#25176](https://github.com/astral-sh/ruff/pull/25176))
- Fix panic in disjoint base check ([#25187](https://github.com/astral-sh/ruff/pull/25187))
- Fix panic in recursive binary inference ([#25189](https://github.com/astral-sh/ruff/pull/25189))
- Fix panic in cyclic `__new__` ([#25185](https://github.com/astral-sh/ruff/pull/25185))
- Fix panic in `reveal_protocol`, `reveal_mro`, etc. with keyword arguments ([#25179](https://github.com/astral-sh/ruff/pull/25179))
- Fix panic in imported overload definition ([#25168](https://github.com/astral-sh/ruff/pull/25168))

### LSP server

- Don't show argument inlay for case-insensitive matches or prefix/suffixes ([#25174](https://github.com/astral-sh/ruff/pull/25174))
- Reduce CPU usage of the LSP when switching between large changesets ([#25142](https://github.com/astral-sh/ruff/pull/25142))

### Core type checking

- Avoid enforcing `__new__` with custom metaclasses ([#25180](https://github.com/astral-sh/ruff/pull/25180))
- Make overload public type reachability-aware ([#25171](https://github.com/astral-sh/ruff/pull/25171))
- Only specialized types of generic class instances should influence variance ([#25124](https://github.com/astral-sh/ruff/pull/25124))
- Preserve ParamSpec argument context through wrapper calls ([#24934](https://github.com/astral-sh/ruff/pull/24934))
- Support partially specialized type context for collection literals ([#24506](https://github.com/astral-sh/ruff/pull/24506))

### Contributors

- [@RasmusNygren](https://github.com/RasmusNygren)
- [@MichaReiser](https://github.com/MichaReiser)
- [@charliermarsh](https://github.com/charliermarsh)
- [@ibraheemdev](https://github.com/ibraheemdev)

## 0.0.36

Released on 2026-05-14.

### Bug fixes

- Fix Go To-Definition for self-imported submodules ([#25106](https://github.com/astral-sh/ruff/pull/25106))
- Fix `ClassVar[Self]` assignment checks for class objects ([#24657](https://github.com/astral-sh/ruff/pull/24657))
- Fix attribute access on `Callable`-bounded TypeVars ([#24793](https://github.com/astral-sh/ruff/pull/24793))
- Fix panic from TypedDict schema cycle with `Self` fields ([#25094](https://github.com/astral-sh/ruff/pull/25094))
- Fix panic from accessing `args[0]` for `static_assert` ([#25149](https://github.com/astral-sh/ruff/pull/25149))
- Fix panic from non-name walrus target access ([#25121](https://github.com/astral-sh/ruff/pull/25121))
- Fix singleton classification for runtime typing objects ([#25099](https://github.com/astral-sh/ruff/pull/25099))
- Guard self-referential `TypeOf` recursion in generic callables ([#24668](https://github.com/astral-sh/ruff/pull/24668))
- Preserve lexical ParamSpec scope for returned Callable annotations ([#24909](https://github.com/astral-sh/ruff/pull/24909))
- Preserve walrus bindings through negated short-circuit conditions ([#25163](https://github.com/astral-sh/ruff/pull/25163))
- Run full iteration analysis on narrowed typevars ([#25143](https://github.com/astral-sh/ruff/pull/25143))

### LSP server

- Classify TypeVar semantic tokens as type parameters ([#24891](https://github.com/astral-sh/ruff/pull/24891))
- Emit folding ranges for an entire block ([#25113](https://github.com/astral-sh/ruff/pull/25113))
- Respect the `includeDeclaration` request parameter ([#24960](https://github.com/astral-sh/ruff/pull/24960))
- Support TypedDict key completions in incomplete, anonymous contexts ([#25147](https://github.com/astral-sh/ruff/pull/25147))

### Performance

- Bound loop-header analysis for large loops ([#24972](https://github.com/astral-sh/ruff/pull/24972))
- Convert inference hash maps to boxed slices on finish ([#25102](https://github.com/astral-sh/ruff/pull/25102))

### Core type checking

- Add support for sentinel values ([PEP 661](https://peps.python.org/pep-0661/)) ([#25082](https://github.com/astral-sh/ruff/pull/25082))
- Hoist path assignment implication checks ([#25107](https://github.com/astral-sh/ruff/pull/25107))
- Preserve TypedDict keys through dict unpacking ([#24523](https://github.com/astral-sh/ruff/pull/24523))
- Treat custom enum `__new__` values as dynamic ([#25136](https://github.com/astral-sh/ruff/pull/25136))

### Contributors

- [@RasmusNygren](https://github.com/RasmusNygren)
- [@charliermarsh](https://github.com/charliermarsh)
- [@JelleZijlstra](https://github.com/JelleZijlstra)
- [@Minibrams](https://github.com/Minibrams)
- [@lerebear](https://github.com/lerebear)
- [@denyszhak](https://github.com/denyszhak)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.35

Released on 2026-05-10.

### Bug fixes

- Allow ParamSpec specialization through unioned generic classes ([#24826](https://github.com/astral-sh/ruff/pull/24826))
- Fix cross-file find-references for keyword arguments ([#25043](https://github.com/astral-sh/ruff/pull/25043))
- Fix comparison between negative and positive literal integers ([#25023](https://github.com/astral-sh/ruff/pull/25023))
- Reject dataclass decorator parameters based on supported Python version ([#25029](https://github.com/astral-sh/ruff/pull/25029))

### LSP server

- Adjust start of block folding range to preserve visible header for character-precise LSP clients. ([#24917](https://github.com/astral-sh/ruff/pull/24917))
- Emit folding ranges from the language server for multi-line block headers. ([#24978](https://github.com/astral-sh/ruff/pull/24978))
- Skip global search for references if identifier is not externally visible ([#25033](https://github.com/astral-sh/ruff/pull/25033))
- Speed-up find-references by using multithreading for cross-file searches ([#25042](https://github.com/astral-sh/ruff/pull/25042))

### CLI

- Include severity in JUnit diagnostics ([#25080](https://github.com/astral-sh/ruff/pull/25080))

### Core type checking

- Check non-generic overload implementations ([#24936](https://github.com/astral-sh/ruff/pull/24936))
- Expand support for narrowing within walruses ([#24968](https://github.com/astral-sh/ruff/pull/24968))
- Filter overloads based on return type for ParamSpec mapping ([#24769](https://github.com/astral-sh/ruff/pull/24769))
- Improve support for recursive types ([#24773](https://github.com/astral-sh/ruff/pull/24773))
- Include TypedDict type context when inferring mixed constructors ([#25039](https://github.com/astral-sh/ruff/pull/25039))
- Include TypedDict type context when inferring string keys ([#25037](https://github.com/astral-sh/ruff/pull/25037))
- Preserve NewType and TypeAliasType in implicit aliases ([#25072](https://github.com/astral-sh/ruff/pull/25072))
- Provide type cntext for generator expression yields ([#25069](https://github.com/astral-sh/ruff/pull/25069))
- Provide type context for boolean operands ([#25070](https://github.com/astral-sh/ruff/pull/25070))
- Selectively promote a union of homogeneous fixed-length tuples to a single variadic tuple ([#24705](https://github.com/astral-sh/ruff/pull/24705))
- Support narrowing on `__class__` checks ([#24997](https://github.com/astral-sh/ruff/pull/24997))
- Use more precise exception types when catching a union ([#25076](https://github.com/astral-sh/ruff/pull/25076))

### Diagnostics

- Include error context for overload consistency diagnostics ([#24950](https://github.com/astral-sh/ruff/pull/24950))

### Performance

- Cache results in desperate module resolution ([#24977](https://github.com/astral-sh/ruff/pull/24977))
- Lazily initialize builder when transforming a union type ([#24929](https://github.com/astral-sh/ruff/pull/24929))
- Project reachability constraints before narrowing ([#24982](https://github.com/astral-sh/ruff/pull/24982))
- Skip parameter accumulation for object variadics ([#24976](https://github.com/astral-sh/ruff/pull/24976))

### Contributors

- [@MichaReiser](https://github.com/MichaReiser)
- [@mtshiba](https://github.com/mtshiba)
- [@dylwil3](https://github.com/dylwil3)
- [@lerebear](https://github.com/lerebear)
- [@carljm](https://github.com/carljm)
- [@charliermarsh](https://github.com/charliermarsh)
- [@dhruvmanila](https://github.com/dhruvmanila)

## 0.0.34

Released on 2026-05-01.

### Bug fixes

- Avoid panic in recursive protocol signature comparisons ([#24665](https://github.com/astral-sh/ruff/pull/24665))
- Avoid panics for syntax error targets in invalid unpacking assignments ([#24663](https://github.com/astral-sh/ruff/pull/24663))
- Fix unbounded type growth in nested-typevar substitutions ([#24803](https://github.com/astral-sh/ruff/pull/24803))
- Prevent string annotation tokens from leaking across notebook cells ([#24919](https://github.com/astral-sh/ruff/pull/24919))
- Support reference finding in stringified annotations ([#24956](https://github.com/astral-sh/ruff/pull/24956))

### LSP server

- Add hover support for PEP 695 type aliases ([#24926](https://github.com/astral-sh/ruff/pull/24926))
- Offer string literal completion suggestions based on expected type ([#24555](https://github.com/astral-sh/ruff/pull/24555))
- Support Go-to Definition, Go-To Declaration, and Find References for TypedDict and NamedTuple initializers ([#24897](https://github.com/astral-sh/ruff/pull/24897))
- Support `Annotated` metadata in semantic tokens ([#24890](https://github.com/astral-sh/ruff/pull/24890))

### Core type checking

- Add support for `functools.partial` ([#24582](https://github.com/astral-sh/ruff/pull/24582))
- Fix ParamSpec defaults and alias variance ([#24479](https://github.com/astral-sh/ruff/pull/24479))
- Fix `TypeIs` assignability with gradual types ([#24928](https://github.com/astral-sh/ruff/pull/24928))
- Infer `dict(**TypedDict)` in `TypedDict` context ([#24709](https://github.com/astral-sh/ruff/pull/24709))
- Support `infer_variance` for legacy `TypeVar` ([#24930](https://github.com/astral-sh/ruff/pull/24930))
- Support variance keywords in `ParamSpec` ([#24927](https://github.com/astral-sh/ruff/pull/24927))
- Sync vendored typeshed stubs ([#24952](https://github.com/astral-sh/ruff/pull/24952)). [Typeshed diff](https://github.com/python/typeshed/compare/c03c2b926422c82ab680d27f3ad2491845000802...e4d32e01bee44241a5e7c33298c261175b9f1bdb)
- Unpack `Union` of `TypedDict` in various sites ([#24958](https://github.com/astral-sh/ruff/pull/24958))

### Diagnostics

- Add missing error context node for protocol to protocol assignability ([#24905](https://github.com/astral-sh/ruff/pull/24905))
- Show a diagnostic for unsupported inferred Python version ([#24581](https://github.com/astral-sh/ruff/pull/24581))

### Performance

- Lazily build TypeVar accumulations ([#24782](https://github.com/astral-sh/ruff/pull/24782))

### Contributors

- [@sharkdp](https://github.com/sharkdp)
- [@MichaReiser](https://github.com/MichaReiser)
- [@lerebear](https://github.com/lerebear)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@charliermarsh](https://github.com/charliermarsh)
- [@mtshiba](https://github.com/mtshiba)
- [@Minibrams](https://github.com/Minibrams)
- [@denyszhak](https://github.com/denyszhak)

## 0.0.33

Released on 2026-04-28.

### Notable changes

- ty now prefers the declared type of an annotated assignment in more situations ([#24802](https://github.com/astral-sh/ruff/pull/24802)).
    Consider this example:

    ```py
    from some_library import untyped_function

    threshold: int | None = 0
    result: str = untyped_function()
    ```

    ty previously favored the *inferred* type of the right hand side expression when `threshold` and `result` were used. This is useful for `threshold`, as it allows something like `threshold += 1` to work without an error: we know that `threshold` could later become `None`, but *right now*, we see that it is an `int`. However, for `result`, the inferred type is `Unknown`. This is *not* a useful type and it can lead to false negatives. Starting with this release, ty will therefore prefer
    the declared type *if the inferred and declared types are mutually assignable*. In the above example, `threshold` will still be inferred as `int` (or rather `Literal[1]`), but `result` will now be inferred as `str`. If you previously added `cast`s to work around this behavior, you should be able to remove them after upgrading.

### Bug fixes

- Fix reporting of annotation-only locals as unused ([#24811](https://github.com/astral-sh/ruff/pull/24811))
- Fix project and workspace selection ([#24824](https://github.com/astral-sh/ruff/pull/24824))
- Fix go-to definition for generic classes ([#24714](https://github.com/astral-sh/ruff/pull/24714))
- Fix receiver coloring for aliased decorators ([#24884](https://github.com/astral-sh/ruff/pull/24884))

### LSP server

- Add support for go-to definition in literal enum member inlay hints ([#24792](https://github.com/astral-sh/ruff/pull/24792))
- Add support for "baking" keyword argument inlay hints into the source code ([#24667](https://github.com/astral-sh/ruff/pull/24667))
- Don't allow inlay hint edits when introducing a non global scope symbol ([#24797](https://github.com/astral-sh/ruff/pull/24797))
- Omit semantic highlighting for unresolved symbols ([#24718](https://github.com/astral-sh/ruff/pull/24718))

### Core type checking

- Support narrowing with aliased conditional expressions ([#24302](https://github.com/astral-sh/ruff/pull/24302))
- Model short-circuiting control flow in Boolean expressions ([#24458](https://github.com/astral-sh/ruff/pull/24458))
- Handle `finally` blocks where all `try`/`except` blocks are terminal ([#24882](https://github.com/astral-sh/ruff/pull/24882))
- Detect invalid `ClassVar` vs instance-attribute overrides ([#24767](https://github.com/astral-sh/ruff/pull/24767))
- Emit diagnostic for invalid uses of `Unpack[...]` ([#24868](https://github.com/astral-sh/ruff/pull/24868))
- Infer lambda parameter types with `Callable` type context ([#24317](https://github.com/astral-sh/ruff/pull/24317))
- Support `**` unpacking of `TypedDict` in dict-literal assignments ([#24703](https://github.com/astral-sh/ruff/pull/24703))
- Support `Unpack[TypedDict]` in `**kwargs` signatures ([#24653](https://github.com/astral-sh/ruff/pull/24653))
- Treat `[*xs]` as an irrefutable pattern when matching on `Sequence` ([#24787](https://github.com/astral-sh/ruff/pull/24787))
- Improve generics solving for unions in invariant positions ([#24698](https://github.com/astral-sh/ruff/pull/24698))
- Improve generics solving for unions when matching against protocols ([#24837](https://github.com/astral-sh/ruff/pull/24837))

### Diagnostics

- Add error context to `invalid-return-type` diagnostics, `invalid-yield` diagnostics, attribute assignment diagnostics ([#24770](https://github.com/astral-sh/ruff/pull/24770), [#24771](https://github.com/astral-sh/ruff/pull/24771))
- Add error context for invalid TypedDict assignments ([#24790](https://github.com/astral-sh/ruff/pull/24790))
- Add error context for invalid intersection type assignments ([#24772](https://github.com/astral-sh/ruff/pull/24772))
- Improve TypedDict to `dict` assignment error diagnostics ([#24768](https://github.com/astral-sh/ruff/pull/24768))
- Add contextual secondary annotations in more places ([#24696](https://github.com/astral-sh/ruff/pull/24696))
- Include full type in `invalid-key` diagnostics for unions of TypedDicts ([#24693](https://github.com/astral-sh/ruff/pull/24693))
- Emit more specific diagnostics for "possibly unbound" errors from context manager dunder methods invoked on a union. ([#24662](https://github.com/astral-sh/ruff/pull/24662))
- Remove duplicate `invalid-type-form` diagnostics for PEP-613 type alias values ([#24760](https://github.com/astral-sh/ruff/pull/24760))
- Improve diagnostics for implicit calls to a possibly unbound unary operator ([#24816](https://github.com/astral-sh/ruff/pull/24816))
- Improve diagnostics for possibly-unbound errors from implicit dunder calls on unions ([#24676](https://github.com/astral-sh/ruff/pull/24676))

### Performance

- Optimize signature checking based on number of arguments ([#24674](https://github.com/astral-sh/ruff/pull/24674))
- Defer union of parameter types ([#24756](https://github.com/astral-sh/ruff/pull/24756))
- Skip checks for gradual vararg calls ([#24748](https://github.com/astral-sh/ruff/pull/24748))

### Other changes

- Fix notifications about watched changes for entities outside any workspace ([#24775](https://github.com/astral-sh/ruff/pull/24775))

### Contributors

- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@lerebear](https://github.com/lerebear)
- [@tonyxwz](https://github.com/tonyxwz)
- [@sharkdp](https://github.com/sharkdp)
- [@felixscherz](https://github.com/felixscherz)
- [@MichaReiser](https://github.com/MichaReiser)
- [@tamird](https://github.com/tamird)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@denyszhak](https://github.com/denyszhak)
- [@charliermarsh](https://github.com/charliermarsh)
- [@mtshiba](https://github.com/mtshiba)
- [@EliteTK](https://github.com/EliteTK)
- [@carljm](https://github.com/carljm)

## 0.0.32

Released on 2026-04-20.

### Bug fixes

- Fix panic when `__get__` uses `Concatenate` `self`-type and wraps a `__call__` ([#24692](https://github.com/astral-sh/ruff/pull/24692))
- Avoid panicking on overloaded `Callable` type context ([#24661](https://github.com/astral-sh/ruff/pull/24661))
- Expand class bases in per-base lint checks ([#24695](https://github.com/astral-sh/ruff/pull/24695), [#24699](https://github.com/astral-sh/ruff/pull/24699))
- Fix stack overflow for binary operator inference involving recursive types ([#24551](https://github.com/astral-sh/ruff/pull/24551))

### LSP server

- Dim out unreachable code in IDEs ([#24580](https://github.com/astral-sh/ruff/pull/24580))
- Do not suggest argument completion when typing the value of a keyword argument ([#24669](https://github.com/astral-sh/ruff/pull/24669))
- Retrieve the docstring from the overload implementation if an `@overload`-decorated function has no docstring ([#23920](https://github.com/astral-sh/ruff/pull/23920))

### Core type checking

- Allow `if` statements in TypedDict bodies ([#24702](https://github.com/astral-sh/ruff/pull/24702))
- Disallow `@disjoint_base` on TypedDicts and Protocols ([#24671](https://github.com/astral-sh/ruff/pull/24671))
- Do not consider a subclass of a `@dataclass_transform`-decorated class to have dataclass-like semantics if it has `type` in its MRO ([#24679](https://github.com/astral-sh/ruff/pull/24679))
- Reject using properties with `Never` setters or deleters ([#24510](https://github.com/astral-sh/ruff/pull/24510))
- Sync vendored typeshed stubs ([#24646](https://github.com/astral-sh/ruff/pull/24646)). [Typeshed diff](https://github.com/python/typeshed/compare/f8f0794d0fe249c06dc9f31a004d85be6cca6ced...c03c2b926422c82ab680d27f3ad2491845000802)

### Diagnostics

- Show error context for assignability diagnostics ([#24309](https://github.com/astral-sh/ruff/pull/24309))
- Use partially qualified names when reporting diagnostics regarding bad calls to methods ([#24560](https://github.com/astral-sh/ruff/pull/24560))
- Reduce source code context window to zero ([#24689](https://github.com/astral-sh/ruff/pull/24689))
- Merge same-file annotations if there is only a single line separating them ([#24694](https://github.com/astral-sh/ruff/pull/24694))

### Performance

- Memoize binary operator return types ([#24700](https://github.com/astral-sh/ruff/pull/24700))
- Gate protocol compatibility on member count ([#24684](https://github.com/astral-sh/ruff/pull/24684))

### Contributors

- [@JelleZijlstra](https://github.com/JelleZijlstra)
- [@kc0506](https://github.com/kc0506)
- [@denyszhak](https://github.com/denyszhak)
- [@carljm](https://github.com/carljm)
- [@dcreager](https://github.com/dcreager)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@dylwil3](https://github.com/dylwil3)
- [@charliermarsh](https://github.com/charliermarsh)
- [@sharkdp](https://github.com/sharkdp)
- [@ibraheemdev](https://github.com/ibraheemdev)

## 0.0.31

Released on 2026-04-15.

### Bug fixes

- Avoid panic from double inference for `namedtuple(typename=T, field_names=x, **{})` ([#24641](https://github.com/astral-sh/ruff/pull/24641))
- Avoid panic from double inference with missing functional `Enum(...)` names ([#24638](https://github.com/astral-sh/ruff/pull/24638))
- Avoid panic from double inference with functional `Enum(value=...)` ([#24639](https://github.com/astral-sh/ruff/pull/24639))
- Fix cases where `invalid-key` fix doesn't converge, and `override-of-final-method` produces invalid syntax ([#24649](https://github.com/astral-sh/ruff/pull/24649))
- Fix unnecessary `ty:ignore` comments inserted by `--add-ignore` for diagnostics starting on the same line ([#24651](https://github.com/astral-sh/ruff/pull/24651))

### CLI

- Add `--fix` mode to enable auto-fix for diagnostics ([#24097](https://github.com/astral-sh/ruff/pull/24097))

### Performance

- Avoid excessive memory usage for dataclasses with many fields ([#24620](https://github.com/astral-sh/ruff/pull/24620))

### Core type checking

- Check inherited `NamedTuple` field conflicts ([#24542](https://github.com/astral-sh/ruff/pull/24542))
- Error when duplicate keywords are provided to TypedDict constructors ([#24449](https://github.com/astral-sh/ruff/pull/24449))
- Respect mixed positional and keyword arguments in TypedDict constructor ([#24448](https://github.com/astral-sh/ruff/pull/24448))
- Respect subclass shadowing for inherited NamedTuple fields ([#24640](https://github.com/astral-sh/ruff/pull/24640))
- Skip `EnumMeta.__call__` for enum constructor signatures ([#24513](https://github.com/astral-sh/ruff/pull/24513))

### Contributors

- [@sharkdp](https://github.com/sharkdp)
- [@Glyphack](https://github.com/Glyphack)
- [@MichaReiser](https://github.com/MichaReiser)
- [@charliermarsh](https://github.com/charliermarsh)

## 0.0.30

Released on 2026-04-13.

As of v0.0.30, ty no longer unions `Unknown` into most inferred types of unannotated attributes. For example:

```python
class Foo:
    def __init__(self) -> None:
        self.value = 1

reveal_type(Foo().value)  # revealed: int
Foo().value = "x"  # error: [invalid-assignment]
```

In previous versions, `reveal_type(Foo().value)` would have included `Unknown`, so the assignment to `"x"` would not have been flagged. Since this can affect inferred attribute types throughout a codebase, upgrading may lead to both new and resolved diagnostics. Initializers of `None` and other non-literal singleton types remain exceptions. See [#24531](https://github.com/astral-sh/ruff/pull/24531) for details.

### Bug fixes

- Disallow bare `ParamSpec` in `Concatenate` prefixes ([#24474](https://github.com/astral-sh/ruff/pull/24474))
- Ensure '/' parameter appears before '\*' when rendering `Callable` types ([#24497](https://github.com/astral-sh/ruff/pull/24497))
- Ensure nested conditional blocks inherit `TYPE_CHECKING` state from outer blocks ([#24470](https://github.com/astral-sh/ruff/pull/24470))
- Fix bad diagnostic range for incorrect implicit `__init_subclass__` calls ([#24541](https://github.com/astral-sh/ruff/pull/24541))
- Fix incorrect assignability of `type[T]` to a metaclass ([#24515](https://github.com/astral-sh/ruff/pull/24515))
- Fix stack overflows from recursive types ([#24413](https://github.com/astral-sh/ruff/pull/24413))
- Server: fix signature help for `ParamSpec`-specialized class calls ([#24399](https://github.com/astral-sh/ruff/pull/24399))
- Use `TypedDict` field types as type context to inform the inference of arguments passed to `TypedDict` constructors ([#24422](https://github.com/astral-sh/ruff/pull/24422))

### LSP server

- Adjust semantic tokens implementation to ensure that type alias values have "type form" syntax highlighting in IDEs ([#24478](https://github.com/astral-sh/ruff/pull/24478))
- Completions: rank symbols from `typing` and `collections` higher than third party re-exports ([#23643](https://github.com/astral-sh/ruff/pull/23643))
- Ignore unsupported editor-selected Python versions ([#24498](https://github.com/astral-sh/ruff/pull/24498))
- Improve `TypedDict` constructor support in the LSP by synthesizing `__init__` ([#24476](https://github.com/astral-sh/ruff/pull/24476), [#24522](https://github.com/astral-sh/ruff/pull/24522), [#24535](https://github.com/astral-sh/ruff/pull/24535))
- Return all attribute definitions for goto definition, rather than just the last definition in the given scope ([#24332](https://github.com/astral-sh/ruff/pull/24332))
- Show `info` subdiagnostics in LSP diagnostic messages ([#24328](https://github.com/astral-sh/ruff/pull/24328))
- Use the context of the kind of object a parameter is expected to receive to inform syntax highlighting of arguments passed to call expressions ([#23949](https://github.com/astral-sh/ruff/pull/23949))

### Diagnostics

- Hide "Rule xyz is enabled"-style hints unless verbose mode was specified ([#24469](https://github.com/astral-sh/ruff/pull/24469))
- Improve consistency of pedantic lints complaining about badly named types ([#24575](https://github.com/astral-sh/ruff/pull/24575))
- Point to the first *reachable* declaration, rather than the first declaration, in declaration-based diagnostics ([#24564](https://github.com/astral-sh/ruff/pull/24564))

### Core type checking

- Add support for functional `Enum(...)` syntax ([#23602](https://github.com/astral-sh/ruff/pull/23602), [#24570](https://github.com/astral-sh/ruff/pull/24570), [#24571](https://github.com/astral-sh/ruff/pull/24571))
- Allow `Final` variable assignments in `__post_init__` ([#24529](https://github.com/astral-sh/ruff/pull/24529))
- Allow partially stringified `type[...]` annotations, e.g. `type["MyClass"]` ([#24518](https://github.com/astral-sh/ruff/pull/24518))
- Emit a diagnostic when attempting to inherit from a class with `__init_subclass__ = None` ([#24543](https://github.com/astral-sh/ruff/pull/24543))
- Fix `TypeGuard` and `TypeIs` narrowing for unbound method calls ([#24612](https://github.com/astral-sh/ruff/pull/24612))
- Fix assignability of intersections with bounded TypeVars ([#24502](https://github.com/astral-sh/ruff/pull/24502))
- Fix excess subscript argument inference for non-generic types so that `list[int][0]` leads to 1 diagnostic, rather than 2 ([#24354](https://github.com/astral-sh/ruff/pull/24354))
- Inherit `dataclass_transform` metadata from metaclass bases ([#24615](https://github.com/astral-sh/ruff/pull/24615))
- Lazily evaluate declaration reachability in field and enum filters ([#24451](https://github.com/astral-sh/ruff/pull/24451))
- Normalize explicit `None` accessors in manual property construction ([#24492](https://github.com/astral-sh/ruff/pull/24492))
- Reject deleting `Final` attributes ([#24508](https://github.com/astral-sh/ruff/pull/24508))
- Respect non-required keys in `TypedDict` unpacking ([#24446](https://github.com/astral-sh/ruff/pull/24446))
- Respect property deleters in attribute deletion checks ([#24500](https://github.com/astral-sh/ruff/pull/24500))
- Stop special-casing `str` constructor ([#24514](https://github.com/astral-sh/ruff/pull/24514))
- Stop unioning `Unknown` into types of un-annotated attributes ([#24531](https://github.com/astral-sh/ruff/pull/24531))
- Support `super()` in metaclass methods ([#24483](https://github.com/astral-sh/ruff/pull/24483))
- Tighten up a few edge cases in `Concatenate` type-expression parsing ([#24172](https://github.com/astral-sh/ruff/pull/24172))
- Use basic blocks for determining if a node is in an `if TYPE_CHECKING` block ([#24394](https://github.com/astral-sh/ruff/pull/24394))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@Glyphack](https://github.com/Glyphack)
- [@MichaReiser](https://github.com/MichaReiser)
- [@sharkdp](https://github.com/sharkdp)
- [@carljm](https://github.com/carljm)
- [@YilunAllenChen](https://github.com/YilunAllenChen)
- [@zanieb](https://github.com/zanieb)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@thejchap](https://github.com/thejchap)

## 0.0.29

Released on 2026-04-05.

### Bug fixes

- Avoid special-casing for `dataclasses.field` if it's not in `field_specifiers` ([#24397](https://github.com/astral-sh/ruff/pull/24397))
- Reject unsupported `environment.python-version` values in configuration files ([#24402](https://github.com/astral-sh/ruff/pull/24402))
- Respect supported lower bounds from `requires-python` ([#24401](https://github.com/astral-sh/ruff/pull/24401))

### Core type checking

- Add support for `types.new_class` ([#23144](https://github.com/astral-sh/ruff/pull/23144))
- Fix PEP 695 type aliases in `with` statement ([#24395](https://github.com/astral-sh/ruff/pull/24395))
- Respect `__new__` and metaclass `__call__` return types ([#24357](https://github.com/astral-sh/ruff/pull/24357))
- Treat enum attributes with type annotations as members ([#23776](https://github.com/astral-sh/ruff/pull/23776))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@carljm](https://github.com/carljm)

## 0.0.28

Released on 2026-04-02.

### Bug fixes

- Mark loop header assignments as used to avoid false positives in "unused variable" diagnostics ([#24336](https://github.com/astral-sh/ruff/pull/24336))

### LSP server

- Show constructor signature of classes when hovering over them ([#24257](https://github.com/astral-sh/ruff/pull/24257))

### Core type checking

- Avoid emitting cascading diagnostics when parsing invalid type expressions ([#24326](https://github.com/astral-sh/ruff/pull/24326))
- Handle most "deep" mutual TypeVar constraints ([#24079](https://github.com/astral-sh/ruff/pull/24079))
- Improve consistency and quality of diagnostics relating to invalid type forms ([#24325](https://github.com/astral-sh/ruff/pull/24325))
- Improve robustness of various type-qualifier-related checks ([#24251](https://github.com/astral-sh/ruff/pull/24251))
- Infer the `extra_items` keyword argument to class-based TypedDicts as an annotation expression ([#24362](https://github.com/astral-sh/ruff/pull/24362))
- Use bidirectional inference to fix false positives on operations such as `x: list[int | None] = [None] * 2` ([#24197](https://github.com/astral-sh/ruff/pull/24197))
- Sync vendored typeshed stubs ([#24340](https://github.com/astral-sh/ruff/pull/24340)). [Typeshed diff](https://github.com/python/typeshed/compare/f8f0794d0fe249c06dc9f31a004d85be6cca6ced...c5e47faeda2cf9d233f91bc1dc95814b0cc7ccba)
- Tighten up validation of subscripts and attributes in type expressions ([#24329](https://github.com/astral-sh/ruff/pull/24329))
- Use `infer_type_expression` for parsing parameter annotations and return-type annotations ([#24353](https://github.com/astral-sh/ruff/pull/24353))
- Use `infer_type_expression` for validating PEP-613 type aliases ([#24370](https://github.com/astral-sh/ruff/pull/24370))
- Validate TypedDict fields when subclassing ([#24338](https://github.com/astral-sh/ruff/pull/24338))
- Validate type qualifiers in functional TypedDict fields and the `extra_items` keyword to functional TypedDicts ([#24360](https://github.com/astral-sh/ruff/pull/24360))
- Improve diagnostics for invalid functional `TypedDict`s ([#24345](https://github.com/astral-sh/ruff/pull/24345))

### Contributors

- [@zsol](https://github.com/zsol)
- [@dcreager](https://github.com/dcreager)
- [@charliermarsh](https://github.com/charliermarsh)
- [@oconnor663](https://github.com/oconnor663)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@Glyphack](https://github.com/Glyphack)

## 0.0.27

Released on 2026-03-31.

### Bug fixes

- Fix panic on debug builds when attempting to provide autocomplete suggestions for `list[int]<CURSOR>()` ([#24167](https://github.com/astral-sh/ruff/pull/24167))
- Fix instance-attribute lookup in methods of protocol classes ([#24213](https://github.com/astral-sh/ruff/pull/24213))
- Fix nested global and nonlocal lookups through forwarding scopes ([#24279](https://github.com/astral-sh/ruff/pull/24279))
- Fix panic on `list[Annotated[()]]` ([#24303](https://github.com/astral-sh/ruff/pull/24303))
- Fix stack overflow on `type A = TypeIs[Callable[[], A]]` ([#24245](https://github.com/astral-sh/ruff/pull/24245))
- Use `_cls` as the name of the first argument for synthesized `collections.namedtuple` constructor methods ([#24333](https://github.com/astral-sh/ruff/pull/24333))

### LSP server

- Fix semantic token classification for properties accessed on instances ([#24065](https://github.com/astral-sh/ruff/pull/24065))
- Grey out unused bindings in the editor ([#23305](https://github.com/astral-sh/ruff/pull/23305))

### Core type checking

- Add bidirectional type context for TypedDict `get()` defaults ([#24231](https://github.com/astral-sh/ruff/pull/24231))
- Add bidirectional type context for TypedDict `pop()` defaults ([#24229](https://github.com/astral-sh/ruff/pull/24229))
- Add support for functional TypedDict ([#24174](https://github.com/astral-sh/ruff/pull/24174), [#24331](https://github.com/astral-sh/ruff/pull/24331), [#24295](https://github.com/astral-sh/ruff/pull/24295))
- Ban type qualifiers in PEP-695 type aliases ([#24242](https://github.com/astral-sh/ruff/pull/24242))
- Enforce `Final` attribute assignment rules for annotated and augmented writes ([#23880](https://github.com/astral-sh/ruff/pull/23880))
- Improve support for `Callable` type context ([#23888](https://github.com/astral-sh/ruff/pull/23888))
- Infer lambda expressions with `Callable` type context ([#22633](https://github.com/astral-sh/ruff/pull/22633))
- Don't incorrectly infer the type of a method as being a singleton type when it's accessed off an instance ([#24039](https://github.com/astral-sh/ruff/pull/24039))
- Propagate type context through `await` expressions ([#24256](https://github.com/astral-sh/ruff/pull/24256))
- Resolve union-likes in emitting union attribute errors ([#24263](https://github.com/astral-sh/ruff/pull/24263))
- Show the user where the variable was declared as `Final` when emitting a diagnostic about a `Final` variable being reassigned ([#24194](https://github.com/astral-sh/ruff/pull/24194))

### Contributors

- [@carljm](https://github.com/carljm)
- [@mvanhorn](https://github.com/mvanhorn)
- [@oconnor663](https://github.com/oconnor663)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@zanieb](https://github.com/zanieb)
- [@denyszhak](https://github.com/denyszhak)
- [@Glyphack](https://github.com/Glyphack)
- [@charliermarsh](https://github.com/charliermarsh)
- [@AlexWaygood](https://github.com/AlexWaygood)

## 0.0.26

Released on 2026-03-26.

### Bug fixes

- Prevent "too many cycle iteration" panics in more situations ([#24061](https://github.com/astral-sh/ruff/pull/24061))
- Fix false positives and false negatives when unpacking a union of tuples into a function call ([#23298](https://github.com/astral-sh/ruff/pull/23298))

### Core type checking

- Add support for `typing.Concatenate` ([#23689](https://github.com/astral-sh/ruff/pull/23689))
- Validate the return type of generator functions ([#24026](https://github.com/astral-sh/ruff/pull/24026))
- Support dataclass field `converter`s ([#23088](https://github.com/astral-sh/ruff/pull/23088))
- Disallow `Self` in metaclass and static methods ([#23231](https://github.com/astral-sh/ruff/pull/23231))
- Improve call inference for keyword-only `dict()` ([#24103](https://github.com/astral-sh/ruff/pull/24103))
- Respect non-explicitly defined `dataclass_transform` params ([#24170](https://github.com/astral-sh/ruff/pull/24170))
- Unconditionally silence diagnostics in unreachable code ([#24179](https://github.com/astral-sh/ruff/pull/24179))
- Respect terminal-function-call narrowing in global scope ([#23245](https://github.com/astral-sh/ruff/pull/23245))

### Performance

- Fix performance regression for narrowing on a larger `Literal` type([#24185](https://github.com/astral-sh/ruff/pull/24185))

### Contributors

- [@sharkdp](https://github.com/sharkdp)
- [@Glyphack](https://github.com/Glyphack)
- [@charliermarsh](https://github.com/charliermarsh)
- [@mtshiba](https://github.com/mtshiba)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@carljm](https://github.com/carljm)
- [@choucavalier](https://github.com/choucavalier)

## 0.0.25

Released on 2026-03-24.

### Breaking changes

- Support `type:ignore[ty:code]` suppressions ([#24096](https://github.com/astral-sh/ruff/pull/24096))

### Bug fixes

- Avoid eager TypedDict diagnostics in `TypedDict | dict` unions ([#24151](https://github.com/astral-sh/ruff/pull/24151))
- Fix Salsa panic propagation ([#24141](https://github.com/astral-sh/ruff/pull/24141))
- Fix folding ranges of comments separated by statements ([#24132](https://github.com/astral-sh/ruff/pull/24132))
- Fix loop-header reachability cycles in conditional unpacking ([#24006](https://github.com/astral-sh/ruff/pull/24006))
- Fix subtyping of intersections containing `NewType`s of unions vs. unions ([#24087](https://github.com/astral-sh/ruff/pull/24087))
- Fix untracked reads in Salsa queries that can lead to backdating panics ([#24051](https://github.com/astral-sh/ruff/pull/24051))
- Prevent tainted loop bindings in cycle normalization ([#24143](https://github.com/astral-sh/ruff/pull/24143))
- Simplify an intersection of `N & ~T` to `Never` if `B & ~T` would simplify to `Never`, where `B` is the concrete base type of a `NewType` `N` ([#24086](https://github.com/astral-sh/ruff/pull/24086))

### LSP

- Preserve blank lines between comments and imports in add-import action ([#24066](https://github.com/astral-sh/ruff/pull/24066))

### Type checking

- Add diagnostic hint for invalid assignments involving invariant generics ([#24032](https://github.com/astral-sh/ruff/pull/24032))
- Add precisely-typed overloads for `TypedDict` update ([#24101](https://github.com/astral-sh/ruff/pull/24101))
- Disallow read-only fields in `TypedDict` updates ([#24128](https://github.com/astral-sh/ruff/pull/24128))
- Expand bounded typevars to their upper bounds when evaluating truthiness comparisons between intersections and literal types ([#24082](https://github.com/astral-sh/ruff/pull/24082))
- Emit `reveal_type` diagnostics in unreachable code ([#24070](https://github.com/astral-sh/ruff/pull/24070))
- Improve `isinstance()` reachability analysis ([#24077](https://github.com/astral-sh/ruff/pull/24077))
- Improve keyword argument narrowing for nested dictionaries ([#24010](https://github.com/astral-sh/ruff/pull/24010))
- Infer `yield` expression types ([#23796](https://github.com/astral-sh/ruff/pull/23796))
- Reduce diagnostic range for `invalid-metaclass` ([#24145](https://github.com/astral-sh/ruff/pull/24145))
- Support narrowing for extended walrus targets ([#24129](https://github.com/astral-sh/ruff/pull/24129))
- Unions/intersections of gradual types should be assignable to `Never` ([#24056](https://github.com/astral-sh/ruff/pull/24056))

### Contributors

- [@MichaReiser](https://github.com/MichaReiser)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@Glyphack](https://github.com/Glyphack)
- [@sharkdp](https://github.com/sharkdp)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@charliermarsh](https://github.com/charliermarsh)
- [@mvanhorn](https://github.com/mvanhorn)
- [@carljm](https://github.com/carljm)

## 0.0.24

Released on 2026-03-19.

### Bug fixes

- Ensure `TypedDict` subscripts for unknown keys return `Unknown` ([#23926](https://github.com/astral-sh/ruff/pull/23926))
- Fix overflow with recursive `TypeIs` ([#23784](https://github.com/astral-sh/ruff/pull/23784))
- Fix variance of frozen dataclass-transform models ([#23931](https://github.com/astral-sh/ruff/pull/23931))

### LSP server

- Improve [semantic token](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_semanticTokens) classification for attribute access on union types ([#23841](https://github.com/astral-sh/ruff/pull/23841))

### Core type checking

- Improve performance and correctness by avoiding inferring intersection types for call arguments as a result of bidirectional inference ([#23933](https://github.com/astral-sh/ruff/pull/23933))
- Narrow keyword arguments when unpacking dictionary instances ([#23436](https://github.com/astral-sh/ruff/pull/23436))
- Discover `/usr/local/lib` dist-packages on Debian/Ubuntu ([#23797](https://github.com/astral-sh/ruff/pull/23797))
- Sync vendored typeshed stubs ([#23963](https://github.com/astral-sh/ruff/pull/23963)). [Typeshed diff](https://github.com/python/typeshed/compare/fa659b1def704dea3dc8e25c7857b23eac69df4d...f8f0794d0fe249c06dc9f31a004d85be6cca6ced)

## Performance

- Introduce fast path for protocol non-assignability ([#23952](https://github.com/astral-sh/ruff/pull/23952))
- Improved generic-solver performance in cases involving overload sets ([#23881](https://github.com/astral-sh/ruff/pull/23881))

### Contributors

- [@Geo5](https://github.com/Geo5)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@charliermarsh](https://github.com/charliermarsh)
- [@dcreager](https://github.com/dcreager)
- [@ollema](https://github.com/ollema)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.23

Released on 2026-03-13.

### Bug fixes

- Fix false-positive diagnostics for PEP-604 union annotations on attribute targets on Python 3.9 when `from __future__ import annotations` is active ([#23915](https://github.com/astral-sh/ruff/pull/23915))
- `dataclass_transform`: Respect `kw_only` overwrites in dataclasses ([#23930](https://github.com/astral-sh/ruff/pull/23930))
- Fix too-many-cycle panics when inferring loop variables with `Literal` types ([#23875](https://github.com/astral-sh/ruff/pull/23875))

### Server

- Fix [folding range](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_foldingRange) classification of lines starting with `#` ([#23831](https://github.com/astral-sh/ruff/pull/23831))
- Fix [folding ranges](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_foldingRange) for notebooks ([#23830](https://github.com/astral-sh/ruff/pull/23830))

### Core type checking

- Split errors for possibly missing submodules into a new `possibly-missing-submodule` error code (enabled by default), and make `possibly-missing-attribute` ignored by default ([#23918](https://github.com/astral-sh/ruff/pull/23918))
- Improve handling of bidirectional inference when ([#23844](https://github.com/astral-sh/ruff/pull/23844))
- Fix inference of conditionally defined properties ([#23925](https://github.com/astral-sh/ruff/pull/23925))

### Improvements to diagnostics

- Clarify in diagnostics that `from __future__ import annotations` only stringifies type annotations ([#23928](https://github.com/astral-sh/ruff/pull/23928))

### Performance improvements

- Avoid duplicated work during multi-inference ([#23923](https://github.com/astral-sh/ruff/pull/23923))

### Contributors

- [@ibraheemdev](https://github.com/ibraheemdev)
- [@sharkdp](https://github.com/sharkdp)
- [@oconnor663](https://github.com/oconnor663)
- [@mtshiba](https://github.com/mtshiba)
- [@MichaReiser](https://github.com/MichaReiser)
- [@carljm](https://github.com/carljm)
- [@AlexWaygood](https://github.com/AlexWaygood)

## 0.0.22

Released on 2026-03-12.

### Bug fixes

- Fix issue where variables could be inferred as `Divergent` if they were assigned using tuple unpacking in loops ([#23812](https://github.com/astral-sh/ruff/pull/23812))
- Allow `error = "all"` in a root `pyproject.toml` file to be overridden using `tool.ty.overrides` in a subdirectory's `pyproject.toml` file ([#23712](https://github.com/astral-sh/ruff/pull/23712))
- Only unsoundly upcast `type[]` types to their constructor `Callable` type during assignability checks, not during redundancy/subtyping checks ([#23834](https://github.com/astral-sh/ruff/pull/23834), [#23901](https://github.com/astral-sh/ruff/pull/23901))
- Fix stack overflow that could occur with certain recursive protocols ([#23870](https://github.com/astral-sh/ruff/pull/23870))

### LSP server

- Improve syntax highlighting by fixing [semantic token](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_semanticTokens) classification for generic class members in annotations ([#23811](https://github.com/astral-sh/ruff/pull/23811))

### CLI

- Add `ty explain <RULE>` CLI command ([#23766](https://github.com/astral-sh/ruff/pull/23766))

### Core type checking

- Add validation for type parameters with defaults after `TypeVarTuple` parameters ([#23807](https://github.com/astral-sh/ruff/pull/23807))
- Allow subtypes of `LiteralString` to be narrowed using equality checks ([#23794](https://github.com/astral-sh/ruff/pull/23794))
- Detect invalid partially stringified PEP-604 unions ([#23285](https://github.com/astral-sh/ruff/pull/23285))
- Disambiguate duplicate-looking overloaded callables in union display ([#23907](https://github.com/astral-sh/ruff/pull/23907))
- Don't promote module-literal types to `types.ModuleType` ([#23786](https://github.com/astral-sh/ruff/pull/23786))
- Improve type context support for `__setitem__` dunder calls ([#23800](https://github.com/astral-sh/ruff/pull/23800))
- Infer `t | {"foo": int}` as `TD` if `t` is an instance of a TypedDict `td` with a `foo: int` key ([#23806](https://github.com/astral-sh/ruff/pull/23806))
- Narrow `T` to `T & str` rather than `str` if `T` is a constrained TypeVar with `str` as one of its constraints ([#23850](https://github.com/astral-sh/ruff/pull/23850))
- Promote `None` to `None | Unknown` in invariant contexts ([#23790](https://github.com/astral-sh/ruff/pull/23790))
- Reject `type[Callable]` in type annotations ([#23753](https://github.com/astral-sh/ruff/pull/23753))
- Support enum member access through enum instances and members ([#23772](https://github.com/astral-sh/ruff/pull/23772))
- Eagerly narrow the type associated with keys of heterogeneous dict literals even when a dict literal appears as a subexpression inside a list or tuple literals ([#23569](https://github.com/astral-sh/ruff/pull/23569))
- Ensure that `T & ~S` is always inferred as a subtype of `U` during generic inference if `T` is understood as a subtype of `U` ([#23728](https://github.com/astral-sh/ruff/pull/23728))
- Optimize and improve cycle recovery by preventing "tainted" unions in cycle normalization ([#23563](https://github.com/astral-sh/ruff/pull/23563))

### Installer

- Prefer downloading releases from Astral's mirror over GitHub ([#2980](https://github.com/astral-sh/ty/pull/2980))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@MichaReiser](https://github.com/MichaReiser)
- [@mtshiba](https://github.com/mtshiba)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@ntBre](https://github.com/ntBre)
- [@oconnor663](https://github.com/oconnor663)
- [@zsol](https://github.com/zsol)

## 0.0.21

Released on 2026-03-05.

### Bug fixes

- Avoid stack overflow with recursive typevar ([#23652](https://github.com/astral-sh/ruff/pull/23652))
- Fix panic on incomplete except handlers ([#23708](https://github.com/astral-sh/ruff/pull/23708))
- Allow unions of different-length iterables in `*args` unpacking into optional positional parameters ([#23124](https://github.com/astral-sh/ruff/pull/23124))
- Don't replace `Any` attributes with `object` after `isinstance` narrowing ([#23725](https://github.com/astral-sh/ruff/pull/23725))

### LSP server

- Exclude decorators from class/def code folding ([#23543](https://github.com/astral-sh/ruff/pull/23543))
- Fix handling of non-Python text documents ([#23704](https://github.com/astral-sh/ruff/pull/23704))

### Configuration

- Add `all` selector to `ty.json` schema ([#23721](https://github.com/astral-sh/ruff/pull/23721))
- Fix precedence of `all` selector in TOML configurations ([#23723](https://github.com/astral-sh/ruff/pull/23723))
- Make `all` selector case-sensitive ([#23713](https://github.com/astral-sh/ruff/pull/23713))

### Type checking

- Add `invalid-enum-member-annotation` lint rule ([#23648](https://github.com/astral-sh/ruff/pull/23648))
- Add a diagnostic for an unused awaitable ([#23650](https://github.com/astral-sh/ruff/pull/23650))
- Add a diagnostic if a `TypeVar` is used to specialize a `ParamSpec`, or vice versa ([#23738](https://github.com/astral-sh/ruff/pull/23738))
- Add more type-variable default validation ([#23639](https://github.com/astral-sh/ruff/pull/23639))
- Add unbound type variable detection in annotations ([#23641](https://github.com/astral-sh/ruff/pull/23641))
- Apply narrowing to walrus values ([#23687](https://github.com/astral-sh/ruff/pull/23687))
- Do not union `Unknown` into unannotated container types ([#23718](https://github.com/astral-sh/ruff/pull/23718))
- Avoid inferring generics with negative intersections ([#23750](https://github.com/astral-sh/ruff/pull/23750))
- More precise types for `name` and `value` of an enum ([#23683](https://github.com/astral-sh/ruff/pull/23683))
- Better preserve user-provided union order in inferred specializations ([#23715](https://github.com/astral-sh/ruff/pull/23715))
- Support narrowing in ternary expressions ([#23726](https://github.com/astral-sh/ruff/pull/23726))
- Validate bare ParamSpec usage in type annotations, and support stringified ParamSpecs as the first argument to `Callable` ([#23625](https://github.com/astral-sh/ruff/pull/23625))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@zsol](https://github.com/zsol)
- [@Gankra](https://github.com/Gankra)
- [@MichaReiser](https://github.com/MichaReiser)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@rizzip](https://github.com/rizzip)
- [@iksuddle](https://github.com/iksuddle)
- [@dcreager](https://github.com/dcreager)
- [@BurntSushi](https://github.com/BurntSushi)
- [@carljm](https://github.com/carljm)
- [@oconnor663](https://github.com/oconnor663)

## 0.0.20

Released on 2026-03-02.

### Bug fixes

- Disallow negative narrowing for `isinstance()` or `issubclass()` checks involving `type[]` types ([#23598](https://github.com/astral-sh/ruff/pull/23598))
- Fix binary operations between an instance of a `NewType` of `float` and an instance of `Any`/`Unknown` ([#23620](https://github.com/astral-sh/ruff/pull/23620))
- Fix bug where ty would think that a `Callable` with a variadic positional parameter could be a subtype of a `Callable` with a positional-or-keyword parameter ([#23610](https://github.com/astral-sh/ruff/pull/23610))
- Fix inference of `t.__mro__` if `t` is an instance of `type[Any]` ([#23632](https://github.com/astral-sh/ruff/pull/23632))
- Fix overloaded callable assignability for unary `Callable` targets ([#23277](https://github.com/astral-sh/ruff/pull/23277))
- Limit recursion depth when displaying self-referential function types ([#23647](https://github.com/astral-sh/ruff/pull/23647))
- Ensure that `python -m ty` works even when ty was installed into an ephemeral virtual environment ([#2852](https://github.com/astral-sh/ty/pull/2852))

### LSP server

- Add support for the LSP protocol's "type hierarchy" feature ([#23566](https://github.com/astral-sh/ruff/pull/23566))

### Type checking

- Add more ParamSpec validation for `P.args` and `P.kwargs` ([#23640](https://github.com/astral-sh/ruff/pull/23640))
- Ban nested `Required`/`NotRequired`, and ban them both outside of `TypedDict` fields ([#23627](https://github.com/astral-sh/ruff/pull/23627))
- Detect inconsistent generic base class specializations that appear in the same MRO ([#23615](https://github.com/astral-sh/ruff/pull/23615))
- Detect invalid uses of `@final` on non-methods ([#23604](https://github.com/astral-sh/ruff/pull/23604))
- Add partial support and validation for `Unpack` when used with tuple types ([#23651](https://github.com/astral-sh/ruff/pull/23651))
- Recurse into tuples and nested tuples when applying special-cased validation of arguments passed to `isinstance()` and `issubclass()` ([#23607](https://github.com/astral-sh/ruff/pull/23607))
- Reject ellipsis literals in odd places in type/annotation expressions ([#23611](https://github.com/astral-sh/ruff/pull/23611))
- Reject functions with PEP-695 type parameters that shadow type parameters from enclosing scopes ([#23619](https://github.com/astral-sh/ruff/pull/23619))
- Reject generic metaclasses parameterized by type variables ([#23628](https://github.com/astral-sh/ruff/pull/23628))
- Treat `dataclass_transform` dataclasses as neither frozen nor non-frozen ([#23366](https://github.com/astral-sh/ruff/pull/23366))
- Validate that type variable defaults don't reference later type parameters or type parameters out of scope ([#23623](https://github.com/astral-sh/ruff/pull/23623))

### Typeshed

- Sync vendored typeshed stubs ([#23642](https://github.com/astral-sh/ruff/pull/23642)). [Typeshed diff](https://github.com/python/typeshed/compare/1b3cec156330a93f6bb22b6636bca38c27f8f721...843c1fd5a148da85e523c1b4ee680226f89986aa)

### Contributors

- [@Hugo-Polloli](https://github.com/Hugo-Polloli)
- [@zanieb](https://github.com/zanieb)
- [@sharkdp](https://github.com/sharkdp)
- [@mtshiba](https://github.com/mtshiba)
- [@carljm](https://github.com/carljm)
- [@charliermarsh](https://github.com/charliermarsh)
- [@sinon](https://github.com/sinon)
- [@BurntSushi](https://github.com/BurntSushi)
- [@oconnor663](https://github.com/oconnor663)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@zsol](https://github.com/zsol)

## 0.0.19

Released on 2026-02-26.

### Bug fixes

- Fix panic in diagnostic rendering when attempting to render a code frame pointing to leading whitespace ([#23458](https://github.com/astral-sh/ruff/pull/23458))
- Fix panics and incorrect inference stemming from incorrectly considering overloads in another file as being associated with a function in the file being checked ([#21977](https://github.com/astral-sh/ruff/pull/21977))
- Fix panic when attempting to narrow the type of a dictionary key that was assigned using a multi-target assignment, e.g. `x = y = {"a": 1}` ([#23523](https://github.com/astral-sh/ruff/pull/23523))
- Fix infinite hang on mutually recursive `TypeAliasType` definitions ([#23397](https://github.com/astral-sh/ruff/pull/23397))

### LSP server

- Fix inlay hints for starred unpacking targets ([#23454](https://github.com/astral-sh/ruff/pull/23454))

### Core type checking

- Fix assignability, subtyping and equivalence checks relating to `typing.Generator` prior to Python 3.13 ([#23386](https://github.com/astral-sh/ruff/pull/23386))
- Understand that a scope's control flow terminates after `await foo()` if `foo` returns `typing.Awaitable[typing.Never]` or similar ([#23479](https://github.com/astral-sh/ruff/pull/23479))
- Implement stricter handling of calls to instances of `type[T]` types ([#23472](https://github.com/astral-sh/ruff/pull/23472))
- Support basic type narrowing for `case {...}:` patterns in `match` statements ([#23462](https://github.com/astral-sh/ruff/pull/23462))
- Fix bugs that could manifest in incorrect overload evaluation, false-positive complaints regarding `assert_type` calls or false-positive `redundant-cast` diagnostics by reimplementing the equivalence type relation as mutual subtyping of top and bottom materializations ([#23428](https://github.com/astral-sh/ruff/pull/23428))
- Fix equality and `__contains__` narrowing with PEP-695 type aliases ([#23545](https://github.com/astral-sh/ruff/pull/23545))
- Support `_value_` annotations on enum classes ([#22228](https://github.com/astral-sh/ruff/pull/22228))

### Improvements to diagnostics

- Improve diagnostics when attempting to specialize non-generic types ([#23516](https://github.com/astral-sh/ruff/pull/23516))
- Render subdiagnostics when `--output-format=github` is specified ([#23455](https://github.com/astral-sh/ruff/pull/23455))

### Performance

- Add a cached method for calculating the intersection of two types ([#23547](https://github.com/astral-sh/ruff/pull/23547))
- Add a cached method for calculating the union of two types ([#23565](https://github.com/astral-sh/ruff/pull/23565))
- Reduce the threshold above which `Literal` types in unions are upcasted to nominal-instance types in situations where the union type is recursively defined ([#23521](https://github.com/astral-sh/ruff/pull/23521))
- Control flow: isolate the calculation of "loop header reachability" in a dedicated, cached function ([#23520](https://github.com/astral-sh/ruff/pull/23520))

### Contributors

- [@AlexWaygood](https://github.com/AlexWaygood)
- [@silamon](https://github.com/silamon)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@Hugo-Polloli](https://github.com/Hugo-Polloli)
- [@charliermarsh](https://github.com/charliermarsh)
- [@knutwannheden](https://github.com/knutwannheden)
- [@oconnor663](https://github.com/oconnor663)
- [@carljm](https://github.com/carljm)
- [@mtshiba](https://github.com/mtshiba)

## 0.0.18

Released on 2026-02-20.

### Bug fixes

- Support classes dynamically created via `type(...)` with cyclic bases ([#22792](https://github.com/astral-sh/ruff/pull/22792))
- Fix incorrect types inferred when unpacking mixed tuples ([#23437](https://github.com/astral-sh/ruff/pull/23437))
- Fix stack overflow for self-referential `TypeOf` in annotations ([#23407](https://github.com/astral-sh/ruff/pull/23407))
- Fix several server panics that could occur when computing semantic tokens for the current file ([#23403](https://github.com/astral-sh/ruff/pull/23403)), [#23398](https://github.com/astral-sh/ruff/pull/23398), [#23401](https://github.com/astral-sh/ruff/pull/23401))

### LSP server

- Add code folding support ([#23393](https://github.com/astral-sh/ruff/pull/23393))
- Add warning message when running `ty server` interactively ([#23416](https://github.com/astral-sh/ruff/pull/23416))
- Exclude test-related symbols from non-first-party packages in auto-import completions ([#23252](https://github.com/astral-sh/ruff/pull/23252))
- Fix bug where diagnostics could disappear after opening an external file ([#23447](https://github.com/astral-sh/ruff/pull/23447))
- Remove spurious destination for Go-To Definition on variables defined in a loop ([#23391](https://github.com/astral-sh/ruff/pull/23391))
- Use the fully qualified name when "baking" an inlay hint into the source code if the scope already contains a variable with the same name as the unqualified name ([#23265](https://github.com/astral-sh/ruff/pull/23265))
- Resolve TypeVars in `call_signature_details` parameter types ([#23149](https://github.com/astral-sh/ruff/pull/23149))

### CLI

- Add `--output-format` to `ty version` ([#23387](https://github.com/astral-sh/ruff/pull/23387))

### Configuration

- Add `replace-imports-with-any` option ([#23122](https://github.com/astral-sh/ruff/pull/23122))
- Support shellexpand for configuration paths ([#23274](https://github.com/astral-sh/ruff/pull/23274))

### Type checking

- Add a new diagnostic to detect invalid class patterns in `match` statements ([#22939](https://github.com/astral-sh/ruff/pull/22939))
- Allow `Self` in `ClassVar` type annotations ([#23362](https://github.com/astral-sh/ruff/pull/23362))
- Consider synthesized methods and `ClassVar`-qualified declarations when determining whether an abstract method has been overridden in a subclass ([#23381](https://github.com/astral-sh/ruff/pull/23381))
- Add a diagnostic when combining `Final` and `ClassVar` ([#23365](https://github.com/astral-sh/ruff/pull/23365))
- Fix return type of `assert_never` ([#23389](https://github.com/astral-sh/ruff/pull/23389))
- Fix `assert_type` diagnostic messages ([#23342](https://github.com/astral-sh/ruff/pull/23342))
- Ban PEP-613 type alias values from containing type-qualifier special forms ([#23444](https://github.com/astral-sh/ruff/pull/23444))
- Infer `LiteralString` for `f"{literal_str_a} {literal_str_b}"` ([#23346](https://github.com/astral-sh/ruff/pull/23346))
- Infer precise types for bit-shift operations on integer literals ([#23301](https://github.com/astral-sh/ruff/pull/23301))
- Make `[abstract-method-in-final-class]` diagnostics less verbose for classes with many abstract methods ([#23379](https://github.com/astral-sh/ruff/pull/23379))
- Improve diagnostics for abstract `@final` classes ([#23376](https://github.com/astral-sh/ruff/pull/23376))
- Only perform literal promotion for implicitly inferred literals ([#23107](https://github.com/astral-sh/ruff/pull/23107))
- Parenthesize callable types when they appear in the return annotation of other callable types ([#23327](https://github.com/astral-sh/ruff/pull/23327))
- Consider a call to a generic function returning `Never` to terminate control flow ([#23419](https://github.com/astral-sh/ruff/pull/23419))
- Support calls to intersection types ([#22469](https://github.com/astral-sh/ruff/pull/22469))
- Validate annotated assignments to attributes on self ([#23388](https://github.com/astral-sh/ruff/pull/23388))
- Treat a bytes-literal type as a subtype of `Sequence[<constituent integers in the bytestring>]` ([#23329](https://github.com/astral-sh/ruff/pull/23329))
- Allow a string-literal argument to match against an `Iterable` parameter in type variable inference. ([#23326](https://github.com/astral-sh/ruff/pull/23326))
- Support narrowing from a `Callable` type returning a `TypeGuard` type ([#23280](https://github.com/astral-sh/ruff/pull/23280))

### Performance

- Consider all code paths as being ambiguously reachable in cases with pathologically large control-flow graphs ([#23399](https://github.com/astral-sh/ruff/pull/23399))

### Typeshed

- Sync vendored typeshed stubs ([#23279](https://github.com/astral-sh/ruff/pull/23279), [Typeshed diff](https://github.com/python/typeshed/compare/fa659b1def704dea3dc8e25c7857b23eac69df4d...1b3cec156330a93f6bb22b6636bca38c27f8f721)). [Typeshed diff](https://github.com/python/typeshed/compare/843c1fd5a148da85e523c1b4ee680226f89986aa...f8f0794d0fe249c06dc9f31a004d85be6cca6ced)

### Contributors

- [@toby-bro](https://github.com/toby-bro)
- [@Hugo-Polloli](https://github.com/Hugo-Polloli)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@BurntSushi](https://github.com/BurntSushi)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@knutwannheden](https://github.com/knutwannheden)
- [@Glyphack](https://github.com/Glyphack)
- [@charliermarsh](https://github.com/charliermarsh)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@abhijeetbodas2001](https://github.com/abhijeetbodas2001)
- [@carljm](https://github.com/carljm)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.17

Released on 2026-02-13.

### Bug fixes

- Avoid `Literal` promotion for constrained `TypeVar`s with `Literal` bounds ([#23209](https://github.com/astral-sh/ruff/pull/23209))
- Fix false positives in `TypeVar` shadowing checks ([#23222](https://github.com/astral-sh/ruff/pull/23222))

### Core type checking

- Support generic protocols ([#21902](https://github.com/astral-sh/ruff/pull/21902))
- Perform control-flow analysis in loops ([#22794](https://github.com/astral-sh/ruff/pull/22794))
- Support `typing.Self` in attribute annotations ([#23108](https://github.com/astral-sh/ruff/pull/23108))
- Support type narrowing in situations with calls to `NoReturn` functions ([#23109](https://github.com/astral-sh/ruff/pull/23109))
- Support type narrowing and reachability analysis based on `os.name` checks ([#23230](https://github.com/astral-sh/ruff/pull/23230))
- Detect overrides of `Final` class variables in subclasses ([#23180](https://github.com/astral-sh/ruff/pull/23180))
- Fix bound method access on `None` ([#23246](https://github.com/astral-sh/ruff/pull/23246))
- Fix method calls on subclasses of `Any` ([#23248](https://github.com/astral-sh/ruff/pull/23248))
- Disallow type variables within PEP-695 type variable bounds and constraints ([#22982](https://github.com/astral-sh/ruff/pull/22982))
- Emit error for attribute access on union where some elements lack the attribute ([#23042](https://github.com/astral-sh/ruff/pull/23042))
- Emit error for invalid typevar defaults ([#23194](https://github.com/astral-sh/ruff/pull/23194))
- Improve display of `ParamSpec`s in some situations ([#23211](https://github.com/astral-sh/ruff/pull/23211))

### LSP server

- Add hover and go-to-declaration support for subscript literals ([#22837](https://github.com/astral-sh/ruff/pull/22837))
- Assign lower completion ranking to deprecated names in auto import ([#23188](https://github.com/astral-sh/ruff/pull/23188))
- Improve spans of references to submodules imported in an `__init__.py` ([#21795](https://github.com/astral-sh/ruff/pull/21795))
- Include conditional symbols (like `datetime.UTC`) in auto-import in more cases ([#23249](https://github.com/astral-sh/ruff/pull/23249))
- Support auto-import for symbols in inlay hints ([#22111](https://github.com/astral-sh/ruff/pull/22111))
- Include overload declarations in find-references ([#23215](https://github.com/astral-sh/ruff/pull/23215))

### Performance

- Avoid `UnionBuilder` overhead when creating a new union from the filtered elements of an existing union ([#22352](https://github.com/astral-sh/ruff/pull/22352))

### Other changes

- Allow discovering dependencies in system Python environments ([#22994](https://github.com/astral-sh/ruff/pull/22994))
- Apply workspace settings to virtual files ([#23228](https://github.com/astral-sh/ruff/pull/23228))
- Add support for `--output-format=junit` ([#22125](https://github.com/astral-sh/ruff/pull/22125))
- Use a smaller diagnostic range for `inconsistent-mro` diagnostics ([#23213](https://github.com/astral-sh/ruff/pull/23213))

### Contributors

- [@carljm](https://github.com/carljm)
- [@BurntSushi](https://github.com/BurntSushi)
- [@charliermarsh](https://github.com/charliermarsh)
- [@Glyphack](https://github.com/Glyphack)
- [@cetanu](https://github.com/cetanu)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@joelostblom](https://github.com/joelostblom)
- [@Gankra](https://github.com/Gankra)
- [@mtshiba](https://github.com/mtshiba)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@Hugo-Polloli](https://github.com/Hugo-Polloli)
- [@sharkdp](https://github.com/sharkdp)
- [@alex](https://github.com/alex)
- [@dcreager](https://github.com/dcreager)
- [@oconnor663](https://github.com/oconnor663)

## 0.0.16

Released on 2026-02-10.

### Bug fixes

- Allow stringified argument in PEP-613 alias to `Optional` ([#23200](https://github.com/astral-sh/ruff/pull/23200))
- Fix fuzzer panic on slice expression in unclosed comprehension ([#23146](https://github.com/astral-sh/ruff/pull/23146))
- Fix combinatorial explosion due to fixed-length tuple expansion in overload matching ([#23190](https://github.com/astral-sh/ruff/pull/23190))
- Respect `@no_type_check` when combined with other decorators ([#23177](https://github.com/astral-sh/ruff/pull/23177))
- Fix diagnostic location for an incorrect sub-call to a specialized ParamSpec ([#23036](https://github.com/astral-sh/ruff/pull/23036))

### LSP server

- Assign lower completions ranking to deprecated functions and classes ([#23089](https://github.com/astral-sh/ruff/pull/23089))
- Change goto-def for class constructors to always go to class definition ([#23071](https://github.com/astral-sh/ruff/pull/23071))
- Ensure diagnostic mode is consistent across projects inside the LSP server ([#23121](https://github.com/astral-sh/ruff/pull/23121))
- Don't include the class `Foo` in autocomplete suggestions when the user is typing out `Foo`'s bases ([#23141](https://github.com/astral-sh/ruff/pull/23141))
- Fix parameter references across files via keyword args ([#23012](https://github.com/astral-sh/ruff/pull/23012))
- Fix wrong inlay hints for overloaded function arguments ([#23179](https://github.com/astral-sh/ruff/pull/23179))
- Support diagnostics in newly created files inside neovim ([#23095](https://github.com/astral-sh/ruff/pull/23095))
- Exclude already-included classes when providing completion suggestions for class bases ([#23085](https://github.com/astral-sh/ruff/pull/23085))

### CLI

- Add support for `TY_OUTPUT_FORMAT` environment variable ([#23123](https://github.com/astral-sh/ruff/pull/23123))
- Fall back to `python3` found in `$PATH` if no environment is found ([#22843](https://github.com/astral-sh/ruff/pull/22843))

### Type checking

- Add `inconsistent-mro` autofix to move `Generic[]` to the end of the bases list ([#22998](https://github.com/astral-sh/ruff/pull/22998))
- Add precise return-type inference for `struct.unpack` ([#22562](https://github.com/astral-sh/ruff/pull/22562), [#23130](https://github.com/astral-sh/ruff/pull/23130))
- Disallow TypeVars within ClassVars ([#23184](https://github.com/astral-sh/ruff/pull/23184))
- Emit diagnostic on unbound call to abstract `@classmethod` or `@staticmethod` ([#23182](https://github.com/astral-sh/ruff/pull/23182))
- Fix false-positive diagnostics when providing the `total=` keyword to `TypedDict` classes that had PEP-695 type parameters ([#23114](https://github.com/astral-sh/ruff/pull/23114))
- Narrow both left- and right-hand operands where possible ([#23084](https://github.com/astral-sh/ruff/pull/23084))
- Narrow chained operators ([#23093](https://github.com/astral-sh/ruff/pull/23093))
- Narrow equality subscripts on either operand ([#23104](https://github.com/astral-sh/ruff/pull/23104))
- Recognize `__dataclass_transform__` to support SQLModel ([#23070](https://github.com/astral-sh/ruff/pull/23070))
- Relax the attribute narrowing condition to support deeper-nested attribute type narrowing ([#22440](https://github.com/astral-sh/ruff/pull/22440))
- Support constrained TypeVar compatibility across function boundaries ([#23103](https://github.com/astral-sh/ruff/pull/23103))
- Support comparison methods (`__gt__`, etc.) where a parameter is annotated with a `Literal` type ([#23100](https://github.com/astral-sh/ruff/pull/23100))
- Support partially specialized type context ([#22748](https://github.com/astral-sh/ruff/pull/22748))
- Use type context when inferring constructor argument types ([#23139](https://github.com/astral-sh/ruff/pull/23139))
- Validate `TypedDict` constructor calls for generic aliases and `type[...]` targets ([#23113](https://github.com/astral-sh/ruff/pull/23113))

### Performance

- Conservative narrowing places optimization ([#22734](https://github.com/astral-sh/ruff/pull/22734))

### Contributors

- [@rbange](https://github.com/rbange)
- [@rayzeller](https://github.com/rayzeller)
- [@charliermarsh](https://github.com/charliermarsh)
- [@11happy](https://github.com/11happy)
- [@figsoda](https://github.com/figsoda)
- [@mtshiba](https://github.com/mtshiba)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@ngnpope](https://github.com/ngnpope)
- [@sakgoyal](https://github.com/sakgoyal)
- [@oconnor663](https://github.com/oconnor663)
- [@ericmarkmartin](https://github.com/ericmarkmartin)
- [@Hugo-Polloli](https://github.com/Hugo-Polloli)
- [@Glyphack](https://github.com/Glyphack)
- [@sharkdp](https://github.com/sharkdp)
- [@carljm](https://github.com/carljm)
- [@BurntSushi](https://github.com/BurntSushi)

## 0.0.15

Released on 2026-02-04.

### Bug fixes

- Add support for resolving imports of packages installed into Debian/Ubuntu `dist-packages` directories ([#22466](https://github.com/astral-sh/ruff/pull/22466))
- Avoid `not-iterable` false positives when iterating over an instance of an intersection type with only negated elements ([#22089](https://github.com/astral-sh/ruff/pull/22089))
- Fix support for stringized annotations in very large files ([#22913](https://github.com/astral-sh/ruff/pull/22913))
- Don't emit Liskov diagnostics for methods with mangled names ([#23062](https://github.com/astral-sh/ruff/pull/23062))
- Enforce that a `Final` symbol cannot be reassigned even after a conditional binding ([#22986](https://github.com/astral-sh/ruff/pull/22986))
- Fix TypedDict construction from existing TypedDict values ([#22904](https://github.com/astral-sh/ruff/pull/22904))
- Fix `Self` resolution for classes nested within methods ([#22964](https://github.com/astral-sh/ruff/pull/22964))
- Fix bidirectional inference with PEP 695 union type aliases ([#22988](https://github.com/astral-sh/ruff/pull/22988))
- Fix edge-case bugs when narrowing tagged unions in `match` statements ([#22870](https://github.com/astral-sh/ruff/pull/22870))
- Fix false-positive diagnostics when iterating over an instance of an intersection that includes a TypeVar of which the upper bound is a union where the union includes a non-iterable type ([#22117](https://github.com/astral-sh/ruff/pull/22117))
- Fix lookup of `__contains__` to respect descriptors ([#23056](https://github.com/astral-sh/ruff/pull/23056))
- Fix narrowing of `nonlocal` variables with conditional assignments ([#22966](https://github.com/astral-sh/ruff/pull/22966))
- Fix several bugs that could affect `NewType`s of `NewType`s of `float` ([#22997](https://github.com/astral-sh/ruff/pull/22997))
- Fix several type narrowing bugs involving PEP-695 type aliases ([#22894](https://github.com/astral-sh/ruff/pull/22894))
- Fix spurious query cycles in decorated functions with parameter defaults, for improved performance and improved determinism ([#23014](https://github.com/astral-sh/ruff/pull/23014))
- Fix unary and comparison operators for TypeVars with union bounds ([#22925](https://github.com/astral-sh/ruff/pull/22925))
- Understand functions as method descriptors even if they are decorated with a decorator annotated as returning a PEP-695 alias to a `Callable` type ([#22902](https://github.com/astral-sh/ruff/pull/22902))
- `dataclass_transform`: Fix visibility of field specifiers when models are nested inside methods ([#23069](https://github.com/astral-sh/ruff/pull/23069))

### LSP server

- Fix hover showing `Unknown` for bare `Final` instance attributes ([#23003](https://github.com/astral-sh/ruff/pull/23003))
- Improve support for goto-type, goto-declaration, hover, and highlighting of string annotations ([#22878](https://github.com/astral-sh/ruff/pull/22878))
- Include setters and deleters when renaming properties ([#22999](https://github.com/astral-sh/ruff/pull/22999))
- Show type qualifiers like `Final` in on-hover hints ([#23005](https://github.com/astral-sh/ruff/pull/23005))

### Configuration

- Add new `unused-type-ignore-comment` rule ([#22790](https://github.com/astral-sh/ruff/pull/22790))
- Add a mechanism to ignore/warn/select all rules ([#22832](https://github.com/astral-sh/ruff/pull/22832))
- Support multiple workspace folders in a single ty LSP server instance ([#22953](https://github.com/astral-sh/ruff/pull/22953))
- Only add `./src` as a search path if `./src/__init__.py(i)` does not exist ([#22851](https://github.com/astral-sh/ruff/pull/22851))

### Type checking

- Add a diagnostic detecting if a variable is declared as `Final` but never has any bindings ([#23001](https://github.com/astral-sh/ruff/pull/23001))
- Add a diagnostic detecting overridden comparison dunder methods on `order=True` dataclasses ([#22689](https://github.com/astral-sh/ruff/pull/22689))
- Add a hint to `invalid-argument-type` and `invalid-assignment` diagnostics if a variable is annotated with a type from the `numbers` module ([#22931](https://github.com/astral-sh/ruff/pull/22931), [#22938](https://github.com/astral-sh/ruff/pull/22938))
- Add diagnostic hint on `unresolved-reference` to suggest using "list" instead of "List" ([#22827](https://github.com/astral-sh/ruff/pull/22827))
- Add new diagnostic for invalid dataclass field orders ([#19825](https://github.com/astral-sh/ruff/pull/19825))
- Allow a subclass method with a positional-only parameter to override a superclass method without that parameter if the parameter in the subclass method has a default value ([#23037](https://github.com/astral-sh/ruff/pull/23037))
- Allow self-referential imports outside the global scope ([#22963](https://github.com/astral-sh/ruff/pull/22963))
- Ban `...` in odd places inside tuple specializations ([#22889](https://github.com/astral-sh/ruff/pull/22889))
- Ban `Required`, `NotRequired` and `ReadOnly` in parameter annotations ([#22888](https://github.com/astral-sh/ruff/pull/22888))
- Ban legacy `TypeVar` bounds or constraints from containing type variables ([#22949](https://github.com/astral-sh/ruff/pull/22949))
- Ban multiple unpacked variadic tuples in a `tuple` specialization ([#22884](https://github.com/astral-sh/ruff/pull/22884))
- Detect generic `Callable`s in the return type of function signatures ([#22954](https://github.com/astral-sh/ruff/pull/22954))
- Detect invalid `isinstance()` and `issubclass()` calls against `TypedDict` classes ([#22887](https://github.com/astral-sh/ruff/pull/22887))
- Detect invalid `issubclass()` calls against `Protocol` classes with non-method members ([#22896](https://github.com/astral-sh/ruff/pull/22896))
- Detect invalid attempts to subclass `Protocol[]` and `Generic[]` simultaneously ([#22948](https://github.com/astral-sh/ruff/pull/22948))
- Emit a diagnostic on incorrect applications of the legacy convention for specifying positional-only parameters ([#22943](https://github.com/astral-sh/ruff/pull/22943))
- Emit an error if a `TypeVarTuple` is used to subscript `Generic` or `Protocol` without being unpacked ([#22952](https://github.com/astral-sh/ruff/pull/22952))
- Fallback to metaclass `__getattr__` or `__getattribute__` when looking up attributes on class objects ([#22985](https://github.com/astral-sh/ruff/pull/22985))
- Fix a bug where an overridden type in a dataclass subclass would not be respected if the dataclass subclass field had a default value but the superclass field did not ([#22965](https://github.com/astral-sh/ruff/pull/22965))
- Improve bidirectional type inference involving PEP-695 type aliases ([#22989](https://github.com/astral-sh/ruff/pull/22989))
- Improve detection of invalid `NewType`s with generic bases ([#22961](https://github.com/astral-sh/ruff/pull/22961))
- Improve reachability analysis when evaluating the truthiness of expressions that involve variables that may not be bound in all code paths ([#22971](https://github.com/astral-sh/ruff/pull/22971))
- Improve the error message if `**` is used with a non-mapping in the context of a call to an overloaded function ([#22921](https://github.com/astral-sh/ruff/pull/22921))
- Infer `ParamSpec` from class constructors for callable protocols ([#22853](https://github.com/astral-sh/ruff/pull/22853))
- Move the location of some `invalid-overload` diagnostics ([#22933](https://github.com/astral-sh/ruff/pull/22933))
- Point to an overload with an invalid `@final` decorator when emitting `invalid-overload` errors for invalid `@final` decorators ([#22893](https://github.com/astral-sh/ruff/pull/22893))
- Avoid false positives when iterating over an instance of an intersection with only negated elements by preserving "pure negation" types in descriptor lookups ([#22907](https://github.com/astral-sh/ruff/pull/22907))
- Promote `Literal` types when inferring elements for very large unannotated tuples, for improved performance ([#22841](https://github.com/astral-sh/ruff/pull/22841))
- Recognize functions with stub bodies in `Protocol` classes as implicitly abstract ([#22838](https://github.com/astral-sh/ruff/pull/22838))
- Reduce false positives involving heterogeneous dicts by tracking dictionary literal keys as individual places ([#22882](https://github.com/astral-sh/ruff/pull/22882))
- Reduce false positives when subscripting classes generic over `TypeVarTuple`s ([#22950](https://github.com/astral-sh/ruff/pull/22950))
- Remove special handling for `Any()` in `match` class patterns ([#23011](https://github.com/astral-sh/ruff/pull/23011))
- Support `type[None]` in type expressions ([#22892](https://github.com/astral-sh/ruff/pull/22892))
- Support legacy namespace packages declared using `pkg_resources.declare_namespace` ([#22987](https://github.com/astral-sh/ruff/pull/22987))
- Sync vendored typeshed stubs ([#23006](https://github.com/astral-sh/ruff/pull/23006)), [Typeshed diff](https://github.com/python/typeshed/compare/cd8b26b0ceef26cd84ab614088140d48680ac7f7...fa659b1def704dea3dc8e25c7857b23eac69df4d)
- Validate signatures of dataclass `__post_init__` methods ([#22730](https://github.com/astral-sh/ruff/pull/22730))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@stefanvanburen](https://github.com/stefanvanburen)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@abhijeetbodas2001](https://github.com/abhijeetbodas2001)
- [@MichaReiser](https://github.com/MichaReiser)
- [@dcreager](https://github.com/dcreager)
- [@PrettyWood](https://github.com/PrettyWood)
- [@sharkdp](https://github.com/sharkdp)
- [@oconnor663](https://github.com/oconnor663)
- [@Feiyang472](https://github.com/Feiyang472)
- [@denyszhak](https://github.com/denyszhak)
- [@mtshiba](https://github.com/mtshiba)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@11happy](https://github.com/11happy)
- [@BurntSushi](https://github.com/BurntSushi)
- [@carljm](https://github.com/carljm)
- [@Gankra](https://github.com/Gankra)
- [@MentalMegalodon](https://github.com/MentalMegalodon)
- [@thejchap](https://github.com/thejchap)

## 0.0.14

Released on 2026-01-26.

### Bug fixes

- Consider keyword arguments when unpacking a variadic argument ([#22796](https://github.com/astral-sh/ruff/pull/22796))
- Fix binary operator false-positive for constrained TypeVars ([#22782](https://github.com/astral-sh/ruff/pull/22782))
- Fix docstring rendering for literal blocks after doctests ([#22676](https://github.com/astral-sh/ruff/pull/22676))
- Fix false-positive `unsupported-operator` for "symmetric" TypeVars ([#22756](https://github.com/astral-sh/ruff/pull/22756))
- Fix panic when overriding a final method using an assignment ([#22831](https://github.com/astral-sh/ruff/pull/22831))
- Fix unary operator false-positive for constrained TypeVars ([#22783](https://github.com/astral-sh/ruff/pull/22783))
- Fix generic functions with a generic (ParamSpec) decorator ([#22544](https://github.com/astral-sh/ruff/pull/22544))
- Fix `memo.changed_at` assertion panics ([#22498](https://github.com/astral-sh/ruff/pull/22498))

### LSP server

- Look up attributes on metaclasses for Go to Definition ([#22758](https://github.com/astral-sh/ruff/pull/22758))
- Suppress type inlay hints for leading-underscore assignments ([#22855](https://github.com/astral-sh/ruff/pull/22855))

### Configuration

- Add `allowed-unresolved-imports` setting ([#22800](https://github.com/astral-sh/ruff/pull/22800))

### Other changes

- Add `assert-type-unspellable-subtype` diagnostic, for failed `assert_type()` where the actual type is a subtype of the named type that can't be spelled in a type expression ([#22815](https://github.com/astral-sh/ruff/pull/22815))
- Add a new `empty-body` return code for functions with stub bodies that have non-`None` return annotations ([#22846](https://github.com/astral-sh/ruff/pull/22846))
- Add diagnostic disambiguation for different type aliases with the same name ([#22852](https://github.com/astral-sh/ruff/pull/22852))
- Add support for dict literals and dict() calls as default values for parameters with TypedDict types ([#22161](https://github.com/astral-sh/ruff/pull/22161))
- Add support for subscripts on intersections ([#22654](https://github.com/astral-sh/ruff/pull/22654))
- Avoid duplicate syntax errors for `await` outside functions ([#22826](https://github.com/astral-sh/ruff/pull/22826))
- Emit an error if the same type parameter appears more than once in a `Generic[]` subscript ([#22738](https://github.com/astral-sh/ruff/pull/22738))
- Emit diagnostic for unimplemented abstract method on @final class ([#22753](https://github.com/astral-sh/ruff/pull/22753))
- Fix GitLab Code Quality output format for empty diagnostics ([#22833](https://github.com/astral-sh/ruff/pull/22833))
- Fix assignment in decorated method causing `Unknown` fallback ([#22778](https://github.com/astral-sh/ruff/pull/22778))
- Fix false negative when using a non-runtime-checkable protocol in a `match` class pattern ([#22836](https://github.com/astral-sh/ruff/pull/22836))
- Improve completion rankings for raise-from/except contexts ([#22775](https://github.com/astral-sh/ruff/pull/22775))
- Improve invalid assignment diagnostics with type context ([#22643](https://github.com/astral-sh/ruff/pull/22643))
- Improve support for kwarg splats in dictionary literals ([#22781](https://github.com/astral-sh/ruff/pull/22781))
- Infer `TypedDict` types with >=1 required key as being always truthy ([#22808](https://github.com/astral-sh/ruff/pull/22808))
- Point to an overload with an invalid `@final` decoator when emitting `invalid-overload` errors for invalid `@final` decorators ([#22812](https://github.com/astral-sh/ruff/pull/22812))
- Require both `*args` and `**kwargs` when calling a `ParamSpec` callable ([#22820](https://github.com/astral-sh/ruff/pull/22820))
- Stricter validation of `TypedDict` definitions ([#22811](https://github.com/astral-sh/ruff/pull/22811))
- Support recursive and stringified annotations in functional `typing.NamedTuple`s ([#22718](https://github.com/astral-sh/ruff/pull/22718))
- Support solving generics involving PEP 695 type aliases ([#22678](https://github.com/astral-sh/ruff/pull/22678))
- Use a more lenient fallback type for failed `namedtuple()` and `NamedTuple` calls ([#22765](https://github.com/astral-sh/ruff/pull/22765))
- Use type context from augmented assignment dunder calls ([#22540](https://github.com/astral-sh/ruff/pull/22540))
- Check that starred arguments in function calls are iterable ([#22805](https://github.com/astral-sh/ruff/pull/22805))

### Contributors

- [@AlexWaygood](https://github.com/AlexWaygood)
- [@maifeeulasad](https://github.com/maifeeulasad)
- [@RasmusNygren](https://github.com/RasmusNygren)
- [@ntBre](https://github.com/ntBre)
- [@Imbuzi](https://github.com/Imbuzi)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@carljm](https://github.com/carljm)
- [@Hugo-Polloli](https://github.com/Hugo-Polloli)
- [@charliermarsh](https://github.com/charliermarsh)
- [@MichaReiser](https://github.com/MichaReiser)
- [@bxff](https://github.com/bxff)
- [@felixscherz](https://github.com/felixscherz)
- [@denyszhak](https://github.com/denyszhak)

## 0.0.13

Released on 2026-01-21.

### Bug fixes

- Fix `--force-exclude` when excluding entire directories ([#22595](https://github.com/astral-sh/ruff/pull/22595))
- Fix missing syntax highlighting for aliased import names ([#22675](https://github.com/astral-sh/ruff/pull/22675))
- Highlight interpolated-parts in t-strings ([#22674](https://github.com/astral-sh/ruff/pull/22674))
- Fix the inferred MRO of functional namedtuple classes ([#22722](https://github.com/astral-sh/ruff/pull/22722))
- Make special cases for subscript inference exhaustive, ensuring that the special casing for tuple subscripts is applied when a union of tuples or an alias to a tuple type is subscripted ([#22035](https://github.com/astral-sh/ruff/pull/22035))

### LSP server

- Improve completion suggestions inside class definitions ([#22571](https://github.com/astral-sh/ruff/pull/22571))
- Improve performance of completions ([#22630](https://github.com/astral-sh/ruff/pull/22630))
- Remove completion suggestions for redundant re-exports that share the same top-most module ([#22581](https://github.com/astral-sh/ruff/pull/22581))

### Core type checking

- Add basic support for overloads in `ParamSpec` ([#21946](https://github.com/astral-sh/ruff/pull/21946))
- Allow `...` as a default value for any parameter if the function is in an `if TYPE_CHECKING` block ([#22624](https://github.com/astral-sh/ruff/pull/22624))
- Allow `if type(x) is Y` narrowing for types other than class-literal types ([#22729](https://github.com/astral-sh/ruff/pull/22729))
- Avoid overload errors when detecting dataclass-on-tuple ([#22687](https://github.com/astral-sh/ruff/pull/22687))
- Avoid reporting overload errors for successful union variants ([#22688](https://github.com/astral-sh/ruff/pull/22688))
- Ban `NewType`s with generic bases ([#22653](https://github.com/astral-sh/ruff/pull/22653))
- Fix PEP 695 type aliases not expanding in overload resolution ([#22589](https://github.com/astral-sh/ruff/pull/22589))
- Fix the return type for synthesized `NamedTuple.__new__` methods ([#22625](https://github.com/astral-sh/ruff/pull/22625))
- Emit diagnostics for `NamedTuple`, `TypedDict`, `Enum` or `Protocol` classes decorated with `@dataclass` ([#22672](https://github.com/astral-sh/ruff/pull/22672))
- Emit `invalid-type-form` diagnostics for stringified annotations where the quoted expression is invalid ([#22752](https://github.com/astral-sh/ruff/pull/22752))
- Infer the implicit type of `cls` in `__new__` methods ([#22584](https://github.com/astral-sh/ruff/pull/22584))
- Make `ModuleType` and `object` attributes available on namespace packages ([#22606](https://github.com/astral-sh/ruff/pull/22606))
- Make `NamedTuple(...)` and `namedtuple(...)` calls stricter ([#22601](https://github.com/astral-sh/ruff/pull/22601))
- Narrow on bool and byte subscripts ([#22684](https://github.com/astral-sh/ruff/pull/22684))
- Narrow on negative subscript indexing ([#22682](https://github.com/astral-sh/ruff/pull/22682))
- Override `__file__` to `str` when applicable on imported modules ([#22333](https://github.com/astral-sh/ruff/pull/22333))
- Add bidirectional inference for comprehensions ([#22564](https://github.com/astral-sh/ruff/pull/22564))
- Recognize string-literal types as subtypes of `Sequence[Literal[chars]]` ([#22415](https://github.com/astral-sh/ruff/pull/22415))
- Add right-hand-side narrowing for `if Foo is type(x)` expressions ([#22608](https://github.com/astral-sh/ruff/pull/22608))
- Add simple syntactic validation for the right-hand side of PEP-613 type aliases ([#22652](https://github.com/astral-sh/ruff/pull/22652))
- Add support for passing `typename` and `field_names` by keyword argument to `collections.namedtuple()` calls ([#22660](https://github.com/astral-sh/ruff/pull/22660))
- Add support for starred unpacking in class bases ([#22591](https://github.com/astral-sh/ruff/pull/22591))
- Validate constructor arguments when a class is used as a decorator ([#22377](https://github.com/astral-sh/ruff/pull/22377))
- Validate field names for `typing.NamedTuple(...)` ([#22599](https://github.com/astral-sh/ruff/pull/22599))
- Add diagnostic on overridden `__setattr__` and `__delattr__` in frozen dataclasses ([#21430](https://github.com/astral-sh/ruff/pull/21430))
- Fix unary operators on `NewType`s of `float` or `complex` ([#22605](https://github.com/astral-sh/ruff/pull/22605))

### Configuration

- Support overriding `respect-type-ignore-comments` ([#22615](https://github.com/astral-sh/ruff/pull/22615))

### Diagnostics

- Don't add a subdiagnostic pointing to the TypeVar definition if the TypeVar is `Self` ([#22646](https://github.com/astral-sh/ruff/pull/22646))
- Show final search path instead of "and 1 more paths" ([#22776](https://github.com/astral-sh/ruff/pull/22776))
- Group `type[]` elements together when displaying union types ([#22592](https://github.com/astral-sh/ruff/pull/22592))

### Performance

- Cache `ClassType::nearest_disjoint_base` ([#22065](https://github.com/astral-sh/ruff/pull/22065))

### Other changes

- Sync vendored typeshed stubs ([#22590](https://github.com/astral-sh/ruff/pull/22590), [Typeshed diff](https://github.com/python/typeshed/compare/d1d5fe58664b30a0c2dde3cd5c3dc8091f0f16ae...cd8b26b0ceef26cd84ab614088140d48680ac7f7)

### Contributors

- [@bxff](https://github.com/bxff)
- [@jhartum](https://github.com/jhartum)
- [@thejchap](https://github.com/thejchap)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@charliermarsh](https://github.com/charliermarsh)
- [@RasmusNygren](https://github.com/RasmusNygren)
- [@mswart](https://github.com/mswart)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@11happy](https://github.com/11happy)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@sinon](https://github.com/sinon)
- [@MichaReiser](https://github.com/MichaReiser)
- [@carljm](https://github.com/carljm)
- [@BurntSushi](https://github.com/BurntSushi)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@oconnor663](https://github.com/oconnor663)
- [@zanieb](https://github.com/zanieb)

## 0.0.12

Released on 2026-01-14.

### Bug fixes

- Avoid panic that could occur when `cast`ing an object to a TypedDict or union of TypedDicts ([#22509](https://github.com/astral-sh/ruff/pull/22509))
- Fix incorrect narrowing for `if type(x) == y` ([#22531](https://github.com/astral-sh/ruff/pull/22531))
- Fix stack overflow with recursive type aliases containing tuple types ([#22543](https://github.com/astral-sh/ruff/pull/22543))
- `functools.total_ordering`: ensure the signatures of generated methods reflect the signature of the user-provided method ([#22496](https://github.com/astral-sh/ruff/pull/22496))
- Support `dataclass_transform` as a function call ([#22378](https://github.com/astral-sh/ruff/pull/22378))
- Use the top materialization of classes for `if type(x) is y` narrowing. For example, `if type(x) is tuple` will cause the type of `x` to be intersected with `tuple[object, ...]` rather than `tuple[Unknown, ...]`. ([#22553](https://github.com/astral-sh/ruff/pull/22553))
- Avoid emitting Liskov violations with respect to a grandparent class if such violations could not be fixed without introducing Liskov violations with respect to a parent class ([#22484](https://github.com/astral-sh/ruff/pull/22484))
- Fix interaction between classmethod, contextmanager, and Self ([#22407](https://github.com/astral-sh/ruff/pull/22407))
- Check contravariant type variable bounds contravariantly in specialization inference ([#22488](https://github.com/astral-sh/ruff/pull/22488))
- Fix false positive for bounded type parameters with NewType ([#22542](https://github.com/astral-sh/ruff/pull/22542))

### Core type checking

- Add support for dynamic `type()` classes ([#22291](https://github.com/astral-sh/ruff/pull/22291), [#22499](https://github.com/astral-sh/ruff/pull/22499), [#22537](https://github.com/astral-sh/ruff/pull/22537), [#22480](https://github.com/astral-sh/ruff/pull/22480))
- Add support for functional `namedtuple` creation ([#22327](https://github.com/astral-sh/ruff/pull/22327), [#22573](https://github.com/astral-sh/ruff/pull/22573), [#22575](https://github.com/astral-sh/ruff/pull/22575), [#22574](https://github.com/astral-sh/ruff/pull/22574))
- Add a diagnostic for non-decorator uses of `final` ([#22555](https://github.com/astral-sh/ruff/pull/22555))
- Add diagnostic to catch generic enums ([#22482](https://github.com/astral-sh/ruff/pull/22482))
- Add diagnostics for `__init_subclass__` argument mismatch ([#22185](https://github.com/astral-sh/ruff/pull/22185))
- Add diagnostics to validate `TypeIs` and `TypeGuard` definitions ([#22300](https://github.com/astral-sh/ruff/pull/22300))
- Apply type narrowing to walrus targets ([#22369](https://github.com/astral-sh/ruff/pull/22369))
- Detect invalid `@total_ordering` applications in non-decorator contexts ([#22486](https://github.com/astral-sh/ruff/pull/22486))
- Fix `@Todo` type for starred expressions ([#22503](https://github.com/astral-sh/ruff/pull/22503))
- Improve disambiguation of types in diagnostics ([#22547](https://github.com/astral-sh/ruff/pull/22547))
- Include type parameters in the display for generic `Callable` types ([#22435](https://github.com/astral-sh/ruff/pull/22435))
- Infer `type[Unknown]` for calls to `type()` when overload evaluation is ambiguous ([#22569](https://github.com/astral-sh/ruff/pull/22569))
- Support assignment to unions of `TypedDict`s ([#22294](https://github.com/astral-sh/ruff/pull/22294))
- Use the key and value parameter types as type context for `__setitem__` dunder calls ([#22148](https://github.com/astral-sh/ruff/pull/22148))
- Narrow the right-hand side of `==`, `!=`, `is` and `is not` conditions when the left-hand side is not narrowable ([#22511](https://github.com/astral-sh/ruff/pull/22511))

### LSP server

- Fix `__file__` type in completions to show `str` instead of `str | None` when the inferred type is `str` ([#22510](https://github.com/astral-sh/ruff/pull/22510))
- Improve rendering of ReST directives in docstrings ([#22512](https://github.com/astral-sh/ruff/pull/22512))

### Contributors

- [@eclbg](https://github.com/eclbg)
- [@RasmusNygren](https://github.com/RasmusNygren)
- [@carljm](https://github.com/carljm)
- [@drbh](https://github.com/drbh)
- [@AryanBagade](https://github.com/AryanBagade)
- [@bxff](https://github.com/bxff)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@charliermarsh](https://github.com/charliermarsh)
- [@AlexWaygood](https://github.com/AlexWaygood)

## 0.0.11

Released on 2026-01-09.

### Bug fixes

- Fix `super()` with TypeVar-annotated `self` and `cls` parameter ([#22208](https://github.com/astral-sh/ruff/pull/22208))
- Only consider fully static pivots when deriving transitive constraints ([#22444](https://github.com/astral-sh/ruff/pull/22444))

### LSP server

- Don't show diagnostics for excluded files ([#22455](https://github.com/astral-sh/ruff/pull/22455))
- Fix goto definition for relative imports in third-party files ([#22457](https://github.com/astral-sh/ruff/pull/22457))
- Improve completion ranking based on origin and exact match ([#22460](https://github.com/astral-sh/ruff/pull/22460))
- Rank top-level module symbols above most other symbols ([#22465](https://github.com/astral-sh/ruff/pull/22465))

### Configuration

- Enable `unused-ignore-comment` by default ([#22474](https://github.com/astral-sh/ruff/pull/22474))

### Performance

- Improve `UnionBuilder` performance by changing `Type::is_subtype_of` calls to `Type::is_redundant_with` ([#22337](https://github.com/astral-sh/ruff/pull/22337))
- Optimize union building for unions with many enum-literal members ([#22363](https://github.com/astral-sh/ruff/pull/22363))-

### Other changes

- Declare support for Python 3.14 ([#2407](https://github.com/astral-sh/ty/pull/2407))
- Remove dark-mode handling from PyPI-uploaded README ([#2422](https://github.com/astral-sh/ty/pull/2422))

### Contributors

- [@dhruvmanila](https://github.com/dhruvmanila)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@charliermarsh](https://github.com/charliermarsh)
- [@BurntSushi](https://github.com/BurntSushi)
- [@MichaReiser](https://github.com/MichaReiser)
- [@dcreager](https://github.com/dcreager)

## 0.0.10

Released on 2026-01-07.

### Bug fixes

- Fix stack overflow due to too small stack size ([#22433](https://github.com/astral-sh/ruff/pull/22433))
- Fix stale semantic tokens after opening the same document with new content ([#22414](https://github.com/astral-sh/ruff/pull/22414))
- Fix handling of `ParamSpec` in overloaded functions ([#22416](https://github.com/astral-sh/ruff/pull/22416))
- Fix comparisons and arithmetic with `NewType`s of `float` ([#22105](https://github.com/astral-sh/ruff/pull/22105))
- Fix several issues with unannotated function return types ([#22425](https://github.com/astral-sh/ruff/pull/22425))
- Fix handling of subclasses in Callables ([#22411](https://github.com/astral-sh/ruff/pull/22411))

### LSP server

- Add support for explicit markdown code fences in docstring rendering ([#22373](https://github.com/astral-sh/ruff/pull/22373), [#22408](https://github.com/astral-sh/ruff/pull/22408))
- Offer completions for `T` when a value has type `Unknown | T` ([#22436](https://github.com/astral-sh/ruff/pull/22436))
- Sort keyword argument completions higher ([#22297](https://github.com/astral-sh/ruff/pull/22297))

### Core type checking

- Add support for `@total_ordering` ([#22181](https://github.com/astral-sh/ruff/pull/22181), [#22183](https://github.com/astral-sh/ruff/pull/22183))
- Better simplification of intersections of tuples ([#22094](https://github.com/astral-sh/ruff/pull/22094))
- Support comparisons between variable-length tuples ([#21824](https://github.com/astral-sh/ruff/pull/21824))
- Emit diagnostics for method definitions and other invalid statements in `TypedDict` class bodies ([#22351](https://github.com/astral-sh/ruff/pull/22351))
- Improve type-narrowing in calls to `len()` ([#22330](https://github.com/astral-sh/ruff/pull/22330))

### CLI

- Add `--add-ignore` CLI option ([#21696](https://github.com/astral-sh/ruff/pull/21696))

### Configuration

- `include = ["myscript"]` will now check `myscript` even though it doesn't have a Python extension ([#22243](https://github.com/astral-sh/ruff/pull/22243))

### Performance

- Optimize intersections with a single negated element ([#22344](https://github.com/astral-sh/ruff/pull/22344))
- Optimize negated types ([#22402](https://github.com/astral-sh/ruff/pull/22402))

### Documentation

- Link to `Callable` `__name__` FAQ directly from `unresolved-attribute` diagnostic ([#22437](https://github.com/astral-sh/ruff/pull/22437))

### Contributors

- [@dhruvmanila](https://github.com/dhruvmanila)
- [@charliermarsh](https://github.com/charliermarsh)
- [@oconnor663](https://github.com/oconnor663)
- [@BurntSushi](https://github.com/BurntSushi)
- [@RasmusNygren](https://github.com/RasmusNygren)
- [@carljm](https://github.com/carljm)
- [@Gankra](https://github.com/Gankra)
- [@MichaReiser](https://github.com/MichaReiser)
- [@AlexWaygood](https://github.com/AlexWaygood)

## 0.0.9

Released on 2026-01-05.

### Bug fixes

- Emit a diagnostic if a class decorator is not a callable accepting a type ([#22375](https://github.com/astral-sh/ruff/pull/22375))
- Fix exhaustiveness inference for unions that include enums ([#22290](https://github.com/astral-sh/ruff/pull/22290))

### Core type checking

- Support `typing.TypeGuard` ([#20974](https://github.com/astral-sh/ruff/pull/20974))
- Treat `__setattr__` as fallback-only ([#22014](https://github.com/astral-sh/ruff/pull/22014))
- Don't expand type aliases via type mappings unless necessary. This means that the displayed signature of a bound methods will no longer eagerly expand type aliases into their aliased types ([#22241](https://github.com/astral-sh/ruff/pull/22241))
- Narrow `TypedDict` unions with `not in` ([#22349](https://github.com/astral-sh/ruff/pull/22349))
- Don't including `property` in subclasses properties ([#22088](https://github.com/astral-sh/ruff/pull/22088))
- Narrow tagged unions of `TypedDict`s in `match` statements ([#22299](https://github.com/astral-sh/ruff/pull/22299))
- Teach bidirectional inference about subtyping. This allows `x` to be inferred as `list[int]` for `x: Iterable[int] = [42]` ([#21930](https://github.com/astral-sh/ruff/pull/21930))
- Support narrowing for tagged unions of tuples where one element of the tuple is a `Literal` type ([#22303](https://github.com/astral-sh/ruff/pull/22303))

### LSP server

- Add autocomplete suggestions for keyword arguments in `class` statements ([#22110](https://github.com/astral-sh/ruff/pull/22110))
- Avoid showing misleading inlay hint for unpacked tuple arguments ([#22286](https://github.com/astral-sh/ruff/pull/22286))

### Other changes

- Sync vendored typeshed stubs ([#22302](https://github.com/astral-sh/ruff/pull/22302), [#22321](https://github.com/astral-sh/ruff/pull/22321), [#22324](https://github.com/astral-sh/ruff/pull/22324)). [Typeshed diff](https://github.com/python/typeshed/compare/3c2dbb1fde8e8d1d59b10161c8bf5fd06c0011cd...d1d5fe58664b30a0c2dde3cd5c3dc8091f0f16ae)

### Contributors

- [@RasmusNygren](https://github.com/RasmusNygren)
- [@ericmarkmartin](https://github.com/ericmarkmartin)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@charliermarsh](https://github.com/charliermarsh)
- [@felixscherz](https://github.com/felixscherz)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@mtshiba](https://github.com/mtshiba)

## 0.0.8

Released on 2025-12-29.

### Breaking changes

- Rename `non-subscriptable` rule to `not-subscriptable` ([#22193](https://github.com/astral-sh/ruff/pull/22193))

### Core type checking

- Promote float and complex when promoting literals ([#22215](https://github.com/astral-sh/ruff/pull/22215))
- Callable type of a type object is not function-like ([#22226](https://github.com/astral-sh/ruff/pull/22226))
- Fix and simplify callable type materializations ([#22213](https://github.com/astral-sh/ruff/pull/22213))

### LSP server

- Add option to disable syntax errors ([#22217](https://github.com/astral-sh/ruff/pull/22217))
- Fix completion in decorators with missing declaration ([#22177](https://github.com/astral-sh/ruff/pull/22177))
- Better completions context detection when typing in decorator positions ([#22224](https://github.com/astral-sh/ruff/pull/22224))
- Limit the returned completions to reduce lag ([#22240](https://github.com/astral-sh/ruff/pull/22240))

### Diagnostics

- Improve wording of `unsupported-base` sub-diagnostic ([#22194](https://github.com/astral-sh/ruff/pull/22194))
- Preserve the invalid assignment diagnostic message when implicitly shadowing a definition ([#22219](https://github.com/astral-sh/ruff/pull/22219))

### Other changes

- Update docker image to use alpine 3.23 and trixie ([#2217](https://github.com/astral-sh/ty/pull/2217))

### Contributors

- [@RasmusNygren](https://github.com/RasmusNygren)
- [@samypr100](https://github.com/samypr100)
- [@silamon](https://github.com/silamon)
- [@carljm](https://github.com/carljm)
- [@MichaReiser](https://github.com/MichaReiser)
- [@MatthewMckee4](https://github.com/MatthewMckee4)

## 0.0.7

Released on 2025-12-24.

### Bug fixes

- Fix classification of modules in `import x as y` for semantic syntax highlighting ([#22175](https://github.com/astral-sh/ruff/pull/22175))
- Fix module resolution on network drives ([#22173](https://github.com/astral-sh/ruff/pull/22173))
- Render the entire diagnostic message in all output formats ([#22164](https://github.com/astral-sh/ruff/pull/22164))

### Other changes

- Add a dedicated diagnostic for TypedDict deletions ([#22123](https://github.com/astral-sh/ruff/pull/22123))
- Check `__delitem__` instead of `__getitem__` for `del x[k]` ([#22121](https://github.com/astral-sh/ruff/pull/22121))
- Fix `@staticmethod` combined with other decorators incorrectly binding `self` ([#22128](https://github.com/astral-sh/ruff/pull/22128))
- Fix implementation of `Top[Callable[..., object]]` ([#22145](https://github.com/astral-sh/ruff/pull/22145))
- Improve diagnostic when `callable` is used in a type expression instead of `collections.abc.Callable` or `typing.Callable` ([#22180](https://github.com/astral-sh/ruff/pull/22180))
- Improve diagnostic when a user tries to access a function attribute on a `Callable` type ([#22182](https://github.com/astral-sh/ruff/pull/22182))
- Include the specialization of a generic `TypedDict` as part of its display ([#22174](https://github.com/astral-sh/ruff/pull/22174))
- Support tuple narrowing based on member checks ([#22167](https://github.com/astral-sh/ruff/pull/22167))
- Synthesize `__delitem__` for TypedDict to allow deleting non-required keys ([#22122](https://github.com/astral-sh/ruff/pull/22122))

### Contributors

- [@MichaReiser](https://github.com/MichaReiser)
- [@ntBre](https://github.com/ntBre)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@charliermarsh](https://github.com/charliermarsh)

## 0.0.6

Released on 2025-12-23.

### Bug fixes

- FIx panic from unexpanded type aliases in implicit tuple aliases ([#22015](https://github.com/astral-sh/ruff/pull/22015))
- Support `type[T]` where `T` is a type alias to a union of types ([#22115](https://github.com/astral-sh/ruff/pull/22115))
- Support `==` narrowing for tuples in unions with disjoint types ([#22129](https://github.com/astral-sh/ruff/pull/22129))
- Respect debug text interpolation in f-strings ([#22151](https://github.com/astral-sh/ruff/pull/22151))
- Fix panic from unstable union-type ordering in fixed-point iteration ([#22070](https://github.com/astral-sh/ruff/pull/22070))

### LSP server

- Add `ty.configuration` and `ty.configurationFile` options ([#22053](https://github.com/astral-sh/ruff/pull/22053))
- Add `diagnosticMode: off` to disable diagnostics while retaining Go To Definition, etc. ([#22073](https://github.com/astral-sh/ruff/pull/22073))
- Set flag to avoid `type[T@f]` being inserted when you double-click on the inlay ([#22139](https://github.com/astral-sh/ruff/pull/22139))
- Use Markdown for completions documentation if the LSP client supports it ([#21752](https://github.com/astral-sh/ruff/pull/21752))

### CLI

- Abort printing diagnostics when pressing `Ctrl+C` ([#22083](https://github.com/astral-sh/ruff/pull/22083))

### Configuration

- Add `respect-type-ignore-comments` configuration option ([#22137](https://github.com/astral-sh/ruff/pull/22137))
- Support custom builtins via `__builtins__.pyi` ([#22021](https://github.com/astral-sh/ruff/pull/22021))

### Other changes

- Bind self with instance in `__get__` ([#22155](https://github.com/astral-sh/ruff/pull/22155))
- Support type inference between protocol instances ([#22120](https://github.com/astral-sh/ruff/pull/22120))
- Synthesize a precise `_fields` attribute for NamedTuples ([#22163](https://github.com/astral-sh/ruff/pull/22163))
- Synthesize a precise `_replace` method for NamedTuples ([#22153](https://github.com/astral-sh/ruff/pull/22153))
- Narrow "tagged unions" of `TypedDict`s ([#22104](https://github.com/astral-sh/ruff/pull/22104))

### Contributors

- [@mtshiba](https://github.com/mtshiba)
- [@charliermarsh](https://github.com/charliermarsh)
- [@Wizzerinus](https://github.com/Wizzerinus)
- [@oconnor663](https://github.com/oconnor663)
- [@MichaReiser](https://github.com/MichaReiser)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@MatthewMckee4](https://github.com/MatthewMckee4)

## 0.0.5

Released on 2025-12-20.

### Bug fixes

- Fix debug-mode server panic when a user typed a class definition by ensuring class arguments are visited in source order for semantic tokens ([#22063](https://github.com/astral-sh/ruff/pull/22063))

### LSP server

- Classify docstrings in semantic tokens during syntax highlighting ([#22031](https://github.com/astral-sh/ruff/pull/22031))

### CLI

- Add `--force-exclude` option ([#22076](https://github.com/astral-sh/ruff/pull/22076))
- Only clear output between two successful checks ([#22078](https://github.com/astral-sh/ruff/pull/22078))

### Other changes

- Add support for `dict(...)` calls in `TypedDict` contexts ([#22113](https://github.com/astral-sh/ruff/pull/22113))
- Speedup bidirectional type-checking involving large unions by avoiding narrowing on non-generic calls ([#22102](https://github.com/astral-sh/ruff/pull/22102))
- Simplify inferred types by avoiding storing multi-inference attempts ([#22062](https://github.com/astral-sh/ruff/pull/22062), [#22103](https://github.com/astral-sh/ruff/pull/22103))
- Improve union builder performance ([#22048](https://github.com/astral-sh/ruff/pull/22048))
- Only prefer declared types in non-covariant positions ([#22068](https://github.com/astral-sh/ruff/pull/22068))
- Respect intersections in iterations ([#21965](https://github.com/astral-sh/ruff/pull/21965))
- Sync vendored typeshed stubs ([#22091](https://github.com/astral-sh/ruff/pull/22091)). [Typeshed diff](https://github.com/python/typeshed/compare/ef2b90c67e5c668b91b3ae121baf00ee5165c30b...3c2dbb1fde8e8d1d59b10161c8bf5fd06c0011cd)
- Understand that the type of `X` on an enum class will be `int` if `X` is defined using `enum.nonmember` in the class definition ([#22025](https://github.com/astral-sh/ruff/pull/22025))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@RasmusNygren](https://github.com/RasmusNygren)
- [@Hugo-Polloli](https://github.com/Hugo-Polloli)
- [@carljm](https://github.com/carljm)
- [@Gankra](https://github.com/Gankra)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.4

Released on 2025-12-18.

### LSP server

- Add support for attribute docstrings ([#22036](https://github.com/astral-sh/ruff/pull/22036))
- Correctly encode multiline tokens for clients not supporting multiline tokens ([#22033](https://github.com/astral-sh/ruff/pull/22033))
- Autocompletions: Don't suggest keyword statements when only expressions are valid ([#22002](https://github.com/astral-sh/ruff/pull/22002))
- Fix goto-declaration on the right-hand side of `from module import submodule` ([#22042](https://github.com/astral-sh/ruff/pull/22042))
- Fix some configuration panics in the LSP ([#22040](https://github.com/astral-sh/ruff/pull/22040))
- Gracefully handle client requests that can't be deserialized ([#22051](https://github.com/astral-sh/ruff/pull/22051))

### Other changes

- Improve performance for large match statements ([#22045](https://github.com/astral-sh/ruff/pull/22045))
- Disable possibly-missing-imports by default ([#22041](https://github.com/astral-sh/ruff/pull/22041))
- Implement disjointness for TypedDicts, significantly speeding up checking of code that uses pydantic ([#22044](https://github.com/astral-sh/ruff/pull/22044))

### Contributors

- [@oconnor663](https://github.com/oconnor663)
- [@MichaReiser](https://github.com/MichaReiser)
- [@Gankra](https://github.com/Gankra)
- [@RasmusNygren](https://github.com/RasmusNygren)
- [@charliermarsh](https://github.com/charliermarsh)

## 0.0.3

Released on 2025-12-17.

### LSP server

- Improve rendering of signatures in hovers ([#22007](https://github.com/astral-sh/ruff/pull/22007))

### Core type checking

- Apply narrowing to `len` calls based on argument size ([#22026](https://github.com/astral-sh/ruff/pull/22026))
- Don't add identical lower/upper bounds multiple times when inferring specializations ([#22030](https://github.com/astral-sh/ruff/pull/22030))
- Improve `unsupported-base` and `invalid-super-argument` diagnostics to avoid extremely long lines when encountering verbose types ([#22022](https://github.com/astral-sh/ruff/pull/22022))
- Improve disambiguation of types in many cases ([#22019](https://github.com/astral-sh/ruff/pull/22019))
- Respect deferred values in keyword arguments etc. for `.pyi` files ([#22029](https://github.com/astral-sh/ruff/pull/22029))
- Handle field specifier functions that accept `**kwargs` and recognize metaclass-based transformers as instances of `DataclassInstance` ([#22018](https://github.com/astral-sh/ruff/pull/22018))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@sharkdp](https://github.com/sharkdp)
- [@Gankra](https://github.com/Gankra)
- [@zanieb](https://github.com/zanieb)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@dcreager](https://github.com/dcreager)

## 0.0.2

Released on 2025-12-16.

This is the first Beta release of ty, which we're now ready to recommend to motivated users for
production use. See our [blog post](https://astral.sh/blog/ty) for more details.

### LSP server

- Improve display of completions to show actual insertion text ([#21988](https://github.com/astral-sh/ruff/pull/21988))
- Improve highlighting of special type syntax in hovers ([#22005](https://github.com/astral-sh/ruff/pull/22005))
- Improve syntax highlighting of constants ([#22006](https://github.com/astral-sh/ruff/pull/22006))

### Core type checking

- Infer precise types for `isinstance(…)` calls involving type variables ([#21999](https://github.com/astral-sh/ruff/pull/21999))
- Infer `TypeVar` specializations for `Callable` types ([#21551](https://github.com/astral-sh/ruff/pull/21551))
- Propagate `classmethod`-ness through decorators returning `Callable`s ([#21958](https://github.com/astral-sh/ruff/pull/21958))
- Improve rendering of default values for function args ([#22010](https://github.com/astral-sh/ruff/pull/22010))
- Don't use implicit superclass annotation when converting a class constructor into a `Callable` ([#22011](https://github.com/astral-sh/ruff/pull/22011))

### Other

- Type checking performance improvement ([#22000](https://github.com/astral-sh/ruff/pull/22000))

### Contributors

- [@sharkdp](https://github.com/sharkdp)
- [@carljm](https://github.com/carljm)
- [@Gankra](https://github.com/Gankra)
- [@BurntSushi](https://github.com/BurntSushi)
- [@dcreager](https://github.com/dcreager)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.1-alpha.35

Released on 2025-12-16.

### Bug fixes

- Fix panic for stringified comprehensions and boolean expressions in type expression ([#21967](https://github.com/astral-sh/ruff/pull/21967))
- Avoid stack overflow when determining inferable typevars ([#21971](https://github.com/astral-sh/ruff/pull/21971))
- Fix false-positive `invalid-method-override` diagnostic on method that uses `Callable` with a `ParamSpec` ([#21934](https://github.com/astral-sh/ruff/pull/21934))
- Disallow explicit specialization of type variables themselves ([#21938](https://github.com/astral-sh/ruff/pull/21938))
- Fix hover type on named expression ("walrus expression") targets ([#21952](https://github.com/astral-sh/ruff/pull/21952))

### LSP server

- Add *"qualify ..."* code fix for undefined references ([#21968](https://github.com/astral-sh/ruff/pull/21968))
- Add new goto-definition targets on inlay hints ([#21950](https://github.com/astral-sh/ruff/pull/21950))
- Remove invalid statement-keyword completions in `for`-statements ([#21979](https://github.com/astral-sh/ruff/pull/21979))

### Core type checking

- Add support for `__qualname__` and other implicit class attributes ([#21966](https://github.com/astral-sh/ruff/pull/21966))
- Emit a diagnostic when a frozen dataclass inherits a non-frozen dataclass and vice versa ([#21962](https://github.com/astral-sh/ruff/pull/21962))
- Emit a diagnostic when a type variable with a default is followed by one without a default ([#21787](https://github.com/astral-sh/ruff/pull/21787))
- Improve diagnostics for unsupported binary operations and unsupported augmented assignments ([#21947](https://github.com/astral-sh/ruff/pull/21947))
- Improve check enforcing that an overloaded function must have an implementation ([#21978](https://github.com/astral-sh/ruff/pull/21978))
- Use unqualified names for displays of `TypeAliasType`s and unbound `ParamSpec`s/`TypeVar`s ([#21960](https://github.com/astral-sh/ruff/pull/21960))

### Performance

- Speed up ty on Linux by using jemalloc ([#21975](https://github.com/astral-sh/ruff/pull/21975))

### Contributors

- [@11happy](https://github.com/11happy)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@mtshiba](https://github.com/mtshiba)
- [@MichaReiser](https://github.com/MichaReiser)
- [@Gankra](https://github.com/Gankra)
- [@silamon](https://github.com/silamon)
- [@dcreager](https://github.com/dcreager)
- [@charliermarsh](https://github.com/charliermarsh)
- [@RasmusNygren](https://github.com/RasmusNygren)
- [@carljm](https://github.com/carljm)

## 0.0.1-alpha.34

Released on 2025-12-12.

### Bug fixes

- Improve solving of a type variable with an upper bound when that type variable appears as one element in a union type ([#21893](https://github.com/astral-sh/ruff/pull/21893))
- Accurately emulate runtime semantics for `kw_only=True` dataclasses such that only fields declared in the immediate class body are understood as being keyword-only ([#21820](https://github.com/astral-sh/ruff/pull/21820))
- Avoid inferring types for invalid binary expressions in string annotations ([#21911](https://github.com/astral-sh/ruff/pull/21911))
- Fix logic used to determine whether two `@final` instance types are disjoint ([#21769](https://github.com/astral-sh/ruff/pull/21769))
- Fix logic used to determine whether two `@final` `type[]` types are disjoint ([#21770](https://github.com/astral-sh/ruff/pull/21770))
- Fix false-positive diagnostics that could arise when analysing cyclic types ([#21910](https://github.com/astral-sh/ruff/pull/21910)), ([#21909](https://github.com/astral-sh/ruff/pull/21909))

### LSP server

- Fix outdated version in publish diagnostics after `didChange` ([#21943](https://github.com/astral-sh/ruff/pull/21943))
- Fix workspace symbols to return members too ([#21926](https://github.com/astral-sh/ruff/pull/21926))
- Adjust scope completions to use all reachable symbols ([#21872](https://github.com/astral-sh/ruff/pull/21872))
- Classify `cls` as class parameter for semantic highlighting ([#21944](https://github.com/astral-sh/ruff/pull/21944))
- Don't show on-hover tooltips for expressions with no inferred type ([#21924](https://github.com/astral-sh/ruff/pull/21924))
- Ignore `__all__` for document and workspace symbol requests ([#21928](https://github.com/astral-sh/ruff/pull/21928))
- Recognize `__all__ += submodule.__all__` in auto-import ([#21918](https://github.com/astral-sh/ruff/pull/21918))
- Stabilize rename ([#21940](https://github.com/astral-sh/ruff/pull/21940))

### Other changes

- Support checking files without extensions ([#21867](https://github.com/astral-sh/ruff/pull/21867))
- Improve performance and semantics by deferring inference of all parameter and return-type annotations ([#21906](https://github.com/astral-sh/ruff/pull/21906))
- Improve resolution of absolute imports in tests ([#21817](https://github.com/astral-sh/ruff/pull/21817))
- Infer the implicit type of the `cls` parameter in `@classmethod` method bodies ([#21685](https://github.com/astral-sh/ruff/pull/21685))
- Support the implicit type of the `cls` parameter in signatures of `@classmethod` methods ([#21771](https://github.com/astral-sh/ruff/pull/21771))
- Uniformly use "not supported" in diagnostics ([#21916](https://github.com/astral-sh/ruff/pull/21916))
- Implement the [equivalence relation](https://typing.python.org/en/latest/spec/glossary.html#term-equivalent) for `TypedDict`s ([#21784](https://github.com/astral-sh/ruff/pull/21784))
- Ensure that the type of the class object `C` is always considered assignable to `type[C[Unknown]]` if `C` is a generic class ([#21883](https://github.com/astral-sh/ruff/pull/21883))
- Improve bad specialization results and error messages ([#21840](https://github.com/astral-sh/ruff/pull/21840))
- Support `NewType`s of `float` and `complex` ([#21886](https://github.com/astral-sh/ruff/pull/21886))

### Contributors

- [@charliermarsh](https://github.com/charliermarsh)
- [@oconnor663](https://github.com/oconnor663)
- [@MichaReiser](https://github.com/MichaReiser)
- [@BurntSushi](https://github.com/BurntSushi)
- [@lucach](https://github.com/lucach)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@mtshiba](https://github.com/mtshiba)
- [@dcreager](https://github.com/dcreager)
- [@sharkdp](https://github.com/sharkdp)
- [@carljm](https://github.com/carljm)
- [@Gankra](https://github.com/Gankra)

## 0.0.1-alpha.33

Released on 2025-12-09.

### Bug fixes

- Fix assignability problem between `tuple[Any, ...]` and `tuple[int, *tuple[int, ...]]` ([#21803](https://github.com/astral-sh/ruff/pull/21803))
- Avoid diagnostic when `typing_extensions.ParamSpec` uses a `default` parameter ([#21839](https://github.com/astral-sh/ruff/pull/21839))
- Avoid crash for invalid `Annotated` subscript ([#21837](https://github.com/astral-sh/ruff/pull/21837))
- Avoid crash for invalid `Final` subscript ([#21828](https://github.com/astral-sh/ruff/pull/21828))
- Fix overload filtering to prefer more precise match when `*args: Any` is involved ([#21859](https://github.com/astral-sh/ruff/pull/21859))
- Handle various invalid explicit specializations for `ParamSpec` ([#21821](https://github.com/astral-sh/ruff/pull/21821))
- Fix stack overflow with recursive generic protocols (depth limit) ([#21858](https://github.com/astral-sh/ruff/pull/21858))

### LSP server

- Add autocomplete suggestions for parameters in function calls ([#21796](https://github.com/astral-sh/ruff/pull/21796))
- Don't create a related diagnostic for the primary annotation of sub-diagnostics ([#21845](https://github.com/astral-sh/ruff/pull/21845))
- Stabilize auto-import ([#21851](https://github.com/astral-sh/ruff/pull/21851))
- Suppress inlay hints when assigning a trivial initializer call ([#21848](https://github.com/astral-sh/ruff/pull/21848))
- Use concise message for LSP clients not supporting related diagnostic information ([#21850](https://github.com/astral-sh/ruff/pull/21850))
- Fix add-import action for `reveal_type` ([#21668](https://github.com/astral-sh/ruff/pull/21668))

### Core type checking

- Infer type variables within generic unions ([#21862](https://github.com/astral-sh/ruff/pull/21862))
- Type inference for `@asynccontextmanager` ([#21876](https://github.com/astral-sh/ruff/pull/21876))
- Make Python-version subdiagnostics less verbose ([#21849](https://github.com/astral-sh/ruff/pull/21849))

### Contributors

- [@BurntSushi](https://github.com/BurntSushi)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@carljm](https://github.com/carljm)
- [@Gankra](https://github.com/Gankra)
- [@charliermarsh](https://github.com/charliermarsh)
- [@RasmusNygren](https://github.com/RasmusNygren)
- [@sharkdp](https://github.com/sharkdp)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.1-alpha.32

Released on 2025-12-05.

### LSP server

- Provide auto-import completion suggestions for modules in more situations ([#21799](https://github.com/astral-sh/ruff/pull/21799))
- Always register the ty server as a [rename provider](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_rename) if the LSP client doesn't support dynamic registration ([#21789](https://github.com/astral-sh/ruff/pull/21789))
- Support auto-import of re-exported symbols in completion suggestions ([#21779](https://github.com/astral-sh/ruff/pull/21779))
- Support renaming import aliases ([#21792](https://github.com/astral-sh/ruff/pull/21792))

### Core type checking

- Support `ParamSpec` ([#21445](https://github.com/astral-sh/ruff/pull/21445))
- Improve the accuracy of the inferred `Callable` supertype of generic classes ([#21798](https://github.com/astral-sh/ruff/pull/21798))
- Increase the limit on the number of elements in a non-recursively defined literal union ([#21683](https://github.com/astral-sh/ruff/pull/21683))
- Fix panics on mutually recursive generic protocols by normalizing the bounds/constraints of cyclic type variables ([#21800](https://github.com/astral-sh/ruff/pull/21800))

### Other changes

- Minor improvements to `assert_type` diagnostics ([#21811](https://github.com/astral-sh/ruff/pull/21811))
- Fix a panic in recursive + generic type aliases ([#21718](https://github.com/astral-sh/ruff/pull/21718))
- Fix a panic when instantiating a type variable with invalid constraints ([#21663](https://github.com/astral-sh/ruff/pull/21663))

### Contributors

- [@BurntSushi](https://github.com/BurntSushi)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@MichaReiser](https://github.com/MichaReiser)
- [@mtshiba](https://github.com/mtshiba)
- [@dcreager](https://github.com/dcreager)
- [@carljm](https://github.com/carljm)
- [@AlexWaygood](https://github.com/AlexWaygood)

## 0.0.1-alpha.31

Released on 2025-12-04.

### Bug fixes

- Fix incorrect `possibly-missing-attribute` diagnostics for `asyncio` imports on Python 3.14 ([#21776](https://github.com/astral-sh/ruff/pull/21776))
- Fix panic for recursive type aliases ([#21778](https://github.com/astral-sh/ruff/pull/21778))

### Core type checking

- Try ancestor `pyproject.toml` directories as search-paths if module resolution fails ([#21745](https://github.com/astral-sh/ruff/pull/21745))
- Sync vendored typeshed stubs ([#21715](https://github.com/astral-sh/ruff/pull/21715)) [Typeshed diff](https://github.com/python/typeshed/compare/f8cdc0bd526301e873cd952eb0d457bdf2554e57...ef2b90c67e5c668b91b3ae121baf00ee5165c30b)

### LSP server

- Don't send publish diagnostics for clients supporting pull diagnostics ([#21772](https://github.com/astral-sh/ruff/pull/21772))
- Fix crash when hovering over string annotations with unknown symbols ([#21782](https://github.com/astral-sh/ruff/pull/21782))

### Diagnostics

- Add subdiagnostic hint if the user wrote `X = Any` rather than `X: Any` ([#21777](https://github.com/astral-sh/ruff/pull/21777))
- Improve the display of various special-form types ([#21775](https://github.com/astral-sh/ruff/pull/21775))

### Contributors

- [@sharkdp](https://github.com/sharkdp)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@MichaReiser](https://github.com/MichaReiser)
- [@Gankra](https://github.com/Gankra)

## 0.0.1-alpha.30

Released on 2025-12-03.

### Bug fixes

- Fix exhaustiveness checking for `match` statements over unions of generic instance types ([#21726](https://github.com/astral-sh/ruff/pull/21726))
- Don't introduce invalid syntax when autofixing `override-of-final-method` ([#21699](https://github.com/astral-sh/ruff/pull/21699))
- Suppress false positives when `dataclasses.dataclass(...)(cls)` is called imperatively ([#21729](https://github.com/astral-sh/ruff/pull/21729))
- Fix false positives for `class F(Generic[*Ts]): ...` ([#21723](https://github.com/astral-sh/ruff/pull/21723))
- Don't confuse multiple occurrences of `typing.Self` when binding bound methods ([#21754](https://github.com/astral-sh/ruff/pull/21754))
- Fix subtyping between `type[T]` and a union type, where `T` is a type variable in scope ([#21740](https://github.com/astral-sh/ruff/pull/21740))
- Fix subtyping between `type[T]` and `U`, where `T` is a type variable in scope and `U` is a type variable not in scope ([#21766](https://github.com/astral-sh/ruff/pull/21766))
- Fix false positives for `type[tuple[...]]` ([#21652](https://github.com/astral-sh/ruff/pull/21652))

### Memory usage improvements

- Significantly reduce memory usage (especially when ty is used as an LSP server) by enabling least-recently-used ([LRU](https://en.wikipedia.org/wiki/Page_replacement_algorithm#Least_recently_used)) cache eviction for module ASTs ([#21749](https://github.com/astral-sh/ruff/pull/21749))

### LSP server

- Add code action to ignore diagnostic on the current line ([#21595](https://github.com/astral-sh/ruff/pull/21595))
- Exclude `typing_extensions` from autocomplete suggestions unless it's really available ([#21731](https://github.com/astral-sh/ruff/pull/21731))
- Fix auto-import code action to handle pre-existing imports ([#21733](https://github.com/astral-sh/ruff/pull/21733))
- Fix "find all references" for types defined in stub files ([#21732](https://github.com/astral-sh/ruff/pull/21732))
- Fix "find all references" for symbols defined via aliased imports ([#21736](https://github.com/astral-sh/ruff/pull/21736))

### Improvements to handling of type aliases

- Default-specialize generic type aliases when they appear unspecialized in type expressions ([#21765](https://github.com/astral-sh/ruff/pull/21765))
- Infer a type alias as being a generic type alias if it includes a type variable in its definition, even in cases where the value subscripted with the type variable is inferred as having a dynamic type such as `Any` or `Unknown` ([#21730](https://github.com/astral-sh/ruff/pull/21730))

### New `NamedTuple` diagnostics

- Detect `NamedTuple` classes that have field names starting with underscores, which is banned at runtime ([#21697](https://github.com/astral-sh/ruff/pull/21697))
- Add a diagnostic detecting overrides of prohibited `NamedTuple` attributes ([#21717](https://github.com/astral-sh/ruff/pull/21717))
- Detect illegal uses of `super()` in methods of `NamedTuple` classes ([#21700](https://github.com/astral-sh/ruff/pull/21700))

### Improvements to existing diagnostics

- Improve diagnostics for unsupported comparison operations ([#21737](https://github.com/astral-sh/ruff/pull/21737))
- For `invalid-type-arguments` diagnostics, show the user where the type variable was defined ([#21727](https://github.com/astral-sh/ruff/pull/21727))
- Extend `invalid-explicit-override` to also cover properties decorated with `@override` that do not override anything ([#21756](https://github.com/astral-sh/ruff/pull/21756))
- Improve `@override`, `@final` and Liskov checks in cases where there are multiple reachable definitions ([#21767](https://github.com/astral-sh/ruff/pull/21767))

### Contributors

- [@MichaReiser](https://github.com/MichaReiser)
- [@charliermarsh](https://github.com/charliermarsh)
- [@dcreager](https://github.com/dcreager)
- [@carljm](https://github.com/carljm)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@BurntSushi](https://github.com/BurntSushi)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@woodruffw](https://github.com/woodruffw)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.1-alpha.29

Released on 2025-11-28.

### Bug Fix

- Fix multiple panics due to recursive type definitions ([#20566](https://github.com/astral-sh/ruff/pull/20566))

### Type inference

- Support `type[T]` where `T` is a type variable ([#21650](https://github.com/astral-sh/ruff/pull/21650))
- More precise inference for a failed specialization of a generic type ([#21651](https://github.com/astral-sh/ruff/pull/21651))
- Detect invalid overrides of methods that are marked as `typing.final` ([#21646](https://github.com/astral-sh/ruff/pull/21646))
- Fix subtyping of `type[Any]` / `type[T]` and protocols ([#21678](https://github.com/astral-sh/ruff/pull/21678))
- Added generics support for implicit and explicit (`typing.TypeAlias`) type aliases ([#21553](https://github.com/astral-sh/ruff/pull/21553))

### LSP server

- Add `import ...` code action for unresolved references ([#21629](https://github.com/astral-sh/ruff/pull/21629))
- Include all members on `type` in autocompletion suggestions for `type[]` types ([#21670](https://github.com/astral-sh/ruff/pull/21670))
- Mark comprehension targets as definitions in semantic highlighting ([#21636](https://github.com/astral-sh/ruff/pull/21636))
- Add IDE autofixes for two "Did you mean...?" suggestions ([#21667](https://github.com/astral-sh/ruff/pull/21667))
- Prettier rendering of `code:: lang` in docstrings ([#21665](https://github.com/astral-sh/ruff/pull/21665))
- Support go-to for patterns and typevars ([#21671](https://github.com/astral-sh/ruff/pull/21671))

### Diagnostics

- Add subdiagnostic hint if a variable with type `Never` is used in a type expression ([#21660](https://github.com/astral-sh/ruff/pull/21660))
- Improve diagnostic messages for invalid type arguments during explicit specialization ([#21635](https://github.com/astral-sh/ruff/pull/21635))

### Contributors

- [@lucach](https://github.com/lucach)
- [@carljm](https://github.com/carljm)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@Gankra](https://github.com/Gankra)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@mtshiba](https://github.com/mtshiba)
- [@oconnor663](https://github.com/oconnor663)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.1-alpha.28

Released on 2025-11-25.

### Bug fixes

- Fix panic for unclosed string literal in type annotation position ([#21592](https://github.com/astral-sh/ruff/pull/21592))

### Type inference

- Check method definitions on subclasses for Liskov violations ([#21436](https://github.com/astral-sh/ruff/pull/21436))
- Eagerly evaluate `types.UnionType` elements as type expressions ([#21531](https://github.com/astral-sh/ruff/pull/21531))
- Extend Liskov checks to also cover classmethods and staticmethods ([#21598](https://github.com/astral-sh/ruff/pull/21598))
- Implement `typing.override` ([#21627](https://github.com/astral-sh/ruff/pull/21627))
- Narrow type context during literal promotion in generic class constructors ([#21574](https://github.com/astral-sh/ruff/pull/21574))
- Retain the function-like-ness of `Callable` types when binding `self` ([#21614](https://github.com/astral-sh/ruff/pull/21614))
- Substitute for `typing.Self` when checking protocol members ([#21569](https://github.com/astral-sh/ruff/pull/21569))
- Implement `TypedDict` structural assignment ([#21467](https://github.com/astral-sh/ruff/pull/21467))
- Make implicit submodule imports re-exported ([#21573](https://github.com/astral-sh/ruff/pull/21573))
- Support PEP 613 `typing.TypeAlias` type aliases ([#21394](https://github.com/astral-sh/ruff/pull/21394))
- Support generic aliases in `type[...]`, like `type[C[int]]` ([#21552](https://github.com/astral-sh/ruff/pull/21552))
- Tighten up handling of subscripts in type expressions ([#21503](https://github.com/astral-sh/ruff/pull/21503))

### LSP server

- Improve go-to-definition and add go-to-definition for inlay hints
    ([#21545](https://github.com/astral-sh/ruff/pull/21545),
    [#21546](https://github.com/astral-sh/ruff/pull/21546),
    [#21544](https://github.com/astral-sh/ruff/pull/21544),
    [#21616](https://github.com/astral-sh/ruff/pull/21616),
    [#21548](https://github.com/astral-sh/ruff/pull/21548))
- Implement go-to-type for inlay type hints ([#21533](https://github.com/astral-sh/ruff/pull/21533))
- Add "remove unused ignore comment" code action ([#21582](https://github.com/astral-sh/ruff/pull/21582))
- Don't suggest completions that aren't subclasses of `BaseException` after `raise` ([#21571](https://github.com/astral-sh/ruff/pull/21571))
- Implement double click to insert inlay hint ([#21600](https://github.com/astral-sh/ruff/pull/21600))
- Fix edge cases for autocomplete suppressions in variable bindings ([#21576](https://github.com/astral-sh/ruff/pull/21576))
- Implement docstring rendering to markdown ([#21550](https://github.com/astral-sh/ruff/pull/21550))
- Support string annotations ([#21577](https://github.com/astral-sh/ruff/pull/21577))
- Improve import detection for completions and support `from ...<CURSOR>` completions ([#21547](https://github.com/astral-sh/ruff/pull/21547))
- Improve handling of hover/goto on imports ([#21572](https://github.com/astral-sh/ruff/pull/21572))
- Don't allow edits of some more invalid syntax types in inlay hints ([#21621](https://github.com/astral-sh/ruff/pull/21621))
- Resolve applicable overloads for hover on an overloaded function call ([#21417](https://github.com/astral-sh/ruff/pull/21417))
- Consistently add the `DEFINITION` modifier when computing semantic tokens ([#21521](https://github.com/astral-sh/ruff/pull/21521))
- Suppress autocomplete suggestions during variable binding ([#21549](https://github.com/astral-sh/ruff/pull/21549))

### CLI

- Exit with code `2` if there's any IO error ([#21508](https://github.com/astral-sh/ruff/pull/21508))

### Diagnostics

- Add hint about resolved Python version when a user attempts to import a member added on a newer version ([#21615](https://github.com/astral-sh/ruff/pull/21615))
- Attach subdiagnostics to `unresolved-import` errors for relative imports as well as absolute imports ([#21554](https://github.com/astral-sh/ruff/pull/21554))
- Avoid expression re-inference for diagnostics ([#21267](https://github.com/astral-sh/ruff/pull/21267))
- Improve message rendering of unused suppression diagnostic ([#21580](https://github.com/astral-sh/ruff/pull/21580))
- Improve concise diagnostics for invalid exceptions when a user catches a tuple of objects ([#21578](https://github.com/astral-sh/ruff/pull/21578))
- Improve diagnostics when `NotImplemented` is called ([#21523](https://github.com/astral-sh/ruff/pull/21523))
- Improve diagnostics when a submodule is not available as an attribute on a module-literal type ([#21561](https://github.com/astral-sh/ruff/pull/21561))
- Improve several "Did you mean?" suggestions ([#21597](https://github.com/astral-sh/ruff/pull/21597))
- Switch the error code from `unresolved-attribute` to `possibly-missing-attribute` for submodules that may not be available ([#21618](https://github.com/astral-sh/ruff/pull/21618))

### Other

- Improve debug messages when imports fail ([#21555](https://github.com/astral-sh/ruff/pull/21555))

### Contributors

- [@Gankra](https://github.com/Gankra)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@RasmusNygren](https://github.com/RasmusNygren)
- [@dcreager](https://github.com/dcreager)
- [@BurntSushi](https://github.com/BurntSushi)
- [@carljm](https://github.com/carljm)
- [@MichaReiser](https://github.com/MichaReiser)
- [@sharkdp](https://github.com/sharkdp)
- [@oconnor663](https://github.com/oconnor663)
- [@lucach](https://github.com/lucach)
- [@ibraheemdev](https://github.com/ibraheemdev)

## 0.0.1-alpha.27

Released on 2025-11-18.

### Bug fixes

- Fix panic for cyclic star imports ([#21428](https://github.com/astral-sh/ruff/pull/21428))
- Fix crashes when using a homebrew Python install ([#21405](https://github.com/astral-sh/ruff/pull/21405))
- Fix incorrect inference of `enum.auto()` for enums with non-`int` mixins, and imprecise inference of `enum.auto()` for single-member enums ([#20541](https://github.com/astral-sh/ruff/pull/20541))
- Fix global symbol lookup from eagerly executed scopes such as comprehensions and classes ([#21317](https://github.com/astral-sh/ruff/pull/21317))
- Fix false positive for instance attributes that are declared as `Final` in the class body but have their value assigned in the class's `__init__` method ([#21158](https://github.com/astral-sh/ruff/pull/21158))
- Use the return type of `__get__` for descriptor lookups even when `__get__` is called with incorrect arguments ([#21424](https://github.com/astral-sh/ruff/pull/21424))
- Consider parameters being declared `global` a syntax error ([#21312](https://github.com/astral-sh/ruff/pull/21312))

### Type inference

- Support `typing.NewType` ([#21157](https://github.com/astral-sh/ruff/pull/21157))
- Support `Callable` in implicit type aliases ([#21496](https://github.com/astral-sh/ruff/pull/21496))
- Support `typing.Union` in implicit type aliases ([#21363](https://github.com/astral-sh/ruff/pull/21363))
- Precise inference for generator expressions ([#21437](https://github.com/astral-sh/ruff/pull/21437))
- Support storing attributes in comprehension scopes ([#20856](https://github.com/astral-sh/ruff/pull/20856))
- Support `isinstance()` and `issubclass()` narrowing when the second argument is a `typing.py` stdlib alias ([#21391](https://github.com/astral-sh/ruff/pull/21391))
- Support `type[…]` and `Type[…]` in implicit type aliases ([#21421](https://github.com/astral-sh/ruff/pull/21421))
- Support attribute-expression `TYPE_CHECKING` conditionals ([#21449](https://github.com/astral-sh/ruff/pull/21449))
- Support class-arguments for dataclass transformers ([#21457](https://github.com/astral-sh/ruff/pull/21457))
- Support legacy `typing` special forms in implicit type aliases ([#21433](https://github.com/astral-sh/ruff/pull/21433))
- Support stringified annotations in value-position `Annotated` instances ([#21447](https://github.com/astral-sh/ruff/pull/21447))
- Support all parameters of dataclass transforms ([#21474](https://github.com/astral-sh/ruff/pull/21474))
- Support `__hash__` semantics and `unsafe_hash` for dataclasses ([#21470](https://github.com/astral-sh/ruff/pull/21470))
- Improve handling of version-specific features of dataclasses ([#21453](https://github.com/astral-sh/ruff/pull/21453))
- Correctly infer the specialization of a non-invariant PEP-695 generic class that has an annotated `self` parameter in its `__init__` method ([#21325](https://github.com/astral-sh/ruff/pull/21325))
- Improve use of type context when inferring the result of a generic constructor call ([#20933](https://github.com/astral-sh/ruff/pull/20933), [#21442](https://github.com/astral-sh/ruff/pull/21442))
- Improve use of type context when inferring the result of a generic call expression ([#21210](https://github.com/astral-sh/ruff/pull/21210))
- Improve heuristics used to decide when it is appropriate to "promote" a `Literal` type such as `Literal[42]` to its instance supertype (in this case, `int`) when solving type variables ([#21439](https://github.com/astral-sh/ruff/pull/21439))
- Improve use of type context to infer conditional expressions ([#21443](https://github.com/astral-sh/ruff/pull/21443))
- Make `__getattr__` available for `ModuleType` instances ([#21450](https://github.com/astral-sh/ruff/pull/21450))
- Introduce implicit local variables for `from` imports of submodules in `__init__.py(i)` ([#21173](https://github.com/astral-sh/ruff/pull/21173))
- Make implicit submodule locals only occur in global scope of an `__init__.py(i)` ([#21370](https://github.com/astral-sh/ruff/pull/21370))
- Make implicit submodule locals also occur for absolute `from` imports in `__init__.py(i)` files ([#21372](https://github.com/astral-sh/ruff/pull/21372))
- Consider `from thispackage import y` a re-export of `y` in `__init__.pyi` ([#21387](https://github.com/astral-sh/ruff/pull/21387))
- Allow PEP-604 unions in stubs and `TYPE_CHECKING` blocks prior to 3.10 ([#21379](https://github.com/astral-sh/ruff/pull/21379))
- Ensure annotation/type expressions in stub files are always deferred ([#21401](https://github.com/astral-sh/ruff/pull/21401), [#21456](https://github.com/astral-sh/ruff/pull/21456))
- Silence false-positive diagnostics when using `typing.Dict` or `typing.Callable` as the second argument to `isinstance()` ([#21386](https://github.com/astral-sh/ruff/pull/21386))
- Sync vendored typeshed stubs ([#21466](https://github.com/astral-sh/ruff/pull/21466)). [Typeshed diff](https://github.com/python/typeshed/compare/bf7214784877c52638844c065360d4814fae4c65...f8cdc0bd526301e873cd952eb0d457bdf2554e57)

### LSP server

- Support for notebooks in VS Code ([#21175](https://github.com/astral-sh/ruff/pull/21175))
- Fix goto-definition for `float` and `complex` in type annotation positions ([#21388](https://github.com/astral-sh/ruff/pull/21388))
- Support goto-definition on call argument inlay hints ([#20349](https://github.com/astral-sh/ruff/pull/20349))
- Add more keywords to scope-based completions ([#21383](https://github.com/astral-sh/ruff/pull/21383))
- Add synthetic members to completions on dataclasses ([#21446](https://github.com/astral-sh/ruff/pull/21446))
- Only suggest the `import` keyword in autocompletions for `from <name> <CURSOR>` statements ([#21291](https://github.com/astral-sh/ruff/pull/21291))
- Suppress completion suggestions following `as` tokens ([#21460](https://github.com/astral-sh/ruff/pull/21460))
- Suppress invalid suggestions in `import` statements ([#21484](https://github.com/astral-sh/ruff/pull/21484))
- Suppress redundant inlay hints for function args ([#21365](https://github.com/astral-sh/ruff/pull/21365))
- Suppress some trivial expression inlay hints ([#21367](https://github.com/astral-sh/ruff/pull/21367))
- Suppress inlay hints for `+1` and `-1` ([#21368](https://github.com/astral-sh/ruff/pull/21368))
- Improve [semantic token](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_semanticTokens) classification for names ([#21399](https://github.com/astral-sh/ruff/pull/21399))
- Classify parameter declarations as definitions when computing semantic tokens ([#21420](https://github.com/astral-sh/ruff/pull/21420))

### Diagnostics

- Better invalid-assignment diagnostics ([#21476](https://github.com/astral-sh/ruff/pull/21476))
- Better concise diagnostic messages ([#21498](https://github.com/astral-sh/ruff/pull/21498))
- Improve subscript assignment diagnostics ([#21411](https://github.com/astral-sh/ruff/pull/21411), [#21452](https://github.com/astral-sh/ruff/pull/21452))
- Improve diagnostic range for `non-subscriptable` diagnostics ([#21461](https://github.com/astral-sh/ruff/pull/21461))
- Improve diagnostics for invalid exceptions ([#21475](https://github.com/astral-sh/ruff/pull/21475))
- Add hyperlinks to rule codes in CLI ([#21502](https://github.com/astral-sh/ruff/pull/21502))

### Performance improvements

- Cache computation of dataclass/NamedTuple/TypedDict fields ([#21512](https://github.com/astral-sh/ruff/pull/21512))
- Faster subscript assignment checks for (unions of) `TypedDict`s ([#21378](https://github.com/astral-sh/ruff/pull/21378))
- Reduce memory allocations for string-literal types ([#21497](https://github.com/astral-sh/ruff/pull/21497))

### Contributors

- [@thejchap](https://github.com/thejchap)
- [@mtshiba](https://github.com/mtshiba)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@Gankra](https://github.com/Gankra)
- [@charliecloudberry](https://github.com/charliecloudberry)
- [@lucach](https://github.com/lucach)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@MichaReiser](https://github.com/MichaReiser)
- [@Glyphack](https://github.com/Glyphack)
- [@dcreager](https://github.com/dcreager)
- [@saada](https://github.com/saada)
- [@11happy](https://github.com/11happy)
- [@oconnor663](https://github.com/oconnor663)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@BurntSushi](https://github.com/BurntSushi)
- [@RasmusNygren](https://github.com/RasmusNygren)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.1-alpha.26

Released on 2025-11-10.

### Bug fixes

- Language server: For [semantic tokens](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_semanticTokens), fix range filtering for tokens starting at the end of the requested range ([#21193](https://github.com/astral-sh/ruff/pull/21193))
- Fix panic due to simplifying `Divergent` types out of intersections types ([#21253](https://github.com/astral-sh/ruff/pull/21253))
- Fix merging of `--exclude` CLI flag and `src.exclude` config-file setting ([#21341](https://github.com/astral-sh/ruff/pull/21341))

### Type inference

- Infer type of `self` for decorated methods and properties ([#21123](https://github.com/astral-sh/ruff/pull/21123))
- Add support for properties that return `Self` ([#21335](https://github.com/astral-sh/ruff/pull/21335))
- Understand legacy and PEP 695 `ParamSpec` ([#21139](https://github.com/astral-sh/ruff/pull/21139))
- Type inference for comprehensions ([#20962](https://github.com/astral-sh/ruff/pull/20962))
- Reachability and narrowing for enum methods ([#21130](https://github.com/astral-sh/ruff/pull/21130))
- Implicit type aliases: Support for PEP 604 unions, `Literal`s, `Optional`, and `Annotated` ([#21195](https://github.com/astral-sh/ruff/pull/21195), [#21296](https://github.com/astral-sh/ruff/pull/21296), [#21321](https://github.com/astral-sh/ruff/pull/21321))
- `dict` is not assignable to `TypedDict` ([#21238](https://github.com/astral-sh/ruff/pull/21238))
- Allow values of type `None` in type expressions ([#21263](https://github.com/astral-sh/ruff/pull/21263))
- Add narrowing for `isinstance()` and `issubclass()` checks that use PEP-604 unions ([#21334](https://github.com/astral-sh/ruff/pull/21334))
- Do not promote `Literal` types when solving type variables in contravariant positions ([#21164](https://github.com/astral-sh/ruff/pull/21164), <https://github.com/astral-sh/ruff/pull/21171>))
- Fix lookup of `__new__` methods on instances ([#21147](https://github.com/astral-sh/ruff/pull/21147))
- Fix narrowing of generic classes in class patterns for `match` statements ([#21150](https://github.com/astral-sh/ruff/pull/21150))
- Improve understanding of disjointness for `@final` classes ([#21167](https://github.com/astral-sh/ruff/pull/21167))
- Fix the inferred signature of the synthesized `__init__` method of a non-dataclass inheriting from a generic dataclass ([#21159](https://github.com/astral-sh/ruff/pull/21159))
- Improve exhaustiveness analysis for type variables with bounds or constraints ([#21172](https://github.com/astral-sh/ruff/pull/21172))
- Prefer exact matches when solving constrained type variables ([#21165](https://github.com/astral-sh/ruff/pull/21165))
- Simplify unions containing multiple type variables during inference ([#21275](https://github.com/astral-sh/ruff/pull/21275))
- Use the declared attribute type when inferring union attribute assignments ([#21170](https://github.com/astral-sh/ruff/pull/21170))
- Sync vendored typeshed stubs ([#21178](https://github.com/astral-sh/ruff/pull/21178)). [Typeshed diff](https://github.com/python/typeshed/compare/d6f4a0f7102b1400a21742cf9b7ea93614e2b6ec...bf7214784877c52638844c065360d4814fae4c65)
- Use declared attribute types as type context when solving type variables ([#21143](https://github.com/astral-sh/ruff/pull/21143))
- Don't union in the inferred type of a parameter's default value when inferring the type of an annotated parameter ([#21208](https://github.com/astral-sh/ruff/pull/21208))
- Support subscripting typing.Literal with a type alias ([#21207](https://github.com/astral-sh/ruff/pull/21207))

### LSP server

- Don't provide completions when in a class or function definition ([#21146](https://github.com/astral-sh/ruff/pull/21146))
- Favor symbols defined in the current file over imported symbols ([#21194](https://github.com/astral-sh/ruff/pull/21194)) and builtin symbols ([#21285](https://github.com/astral-sh/ruff/pull/21285))

### Diagnostics

- Add diagnostics for `isinstance()` and `issubclass()` calls that use invalid PEP-604 unions for their second argument ([#21343](https://github.com/astral-sh/ruff/pull/21343))
- Don't assume in diagnostic messages that a `TypedDict` key error is about subscript access ([#21166](https://github.com/astral-sh/ruff/pull/21166))

### Other changes

- Consistently wrap tokens in parser diagnostics in `backticks` instead of 'quotes' ([#21163](https://github.com/astral-sh/ruff/pull/21163))
- Discover the `site-packages` directory from the environment that ty is installed in ([#21286](https://github.com/astral-sh/ruff/pull/21286)), improving the ergonomics of `uvx ty check`
- Support implicit imports of submodules in `__init__.pyi` ([#20855](https://github.com/astral-sh/ruff/pull/20855))
- Use "cannot" consistently over "can not" in diagnostics ([#21255](https://github.com/astral-sh/ruff/pull/21255))
- Resolve `from foo import bar` to the `foo.bar` submodule rather than using the `__getattr__` function in `foo/__init__.py` (in situations where they both exist)([#21260](https://github.com/astral-sh/ruff/pull/21260))

### Contributors

- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@sharkdp](https://github.com/sharkdp)
- [@Gankra](https://github.com/Gankra)
- [@saada](https://github.com/saada)
- [@zanieb](https://github.com/zanieb)
- [@MichaReiser](https://github.com/MichaReiser)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@lucach](https://github.com/lucach)
- [@mtshiba](https://github.com/mtshiba)
- [@carljm](https://github.com/carljm)

## 0.0.1-alpha.25

Released on 2025-10-29.

### Bug fixes

- Fix bug where ty would think all types had an `__mro__` attribute ([#20995](https://github.com/astral-sh/ruff/pull/20995))
- Fix rare panic with highly cyclic `TypeVar` definitions ([#21059](https://github.com/astral-sh/ruff/pull/21059))
- Fix infinite recursion with generic type aliases ([#20969](https://github.com/astral-sh/ruff/pull/20969))
- Add missing newline before first diagnostic in CLI output ([#21058](https://github.com/astral-sh/ruff/pull/21058))
- Make the ty server's auto-import feature skip symbols in the current module ([#21100](https://github.com/astral-sh/ruff/pull/21100))
- Don't provide goto-definition for definitions which are not reexported in builtins ([#21127](https://github.com/astral-sh/ruff/pull/21127))
- Avoid duplicate diagnostics during multi-inference of standalone expressions ([#21056](https://github.com/astral-sh/ruff/pull/21056))

### Type inference and diagnostics

- Use constructor parameter types as context to inform solving type variables ([#21054](https://github.com/astral-sh/ruff/pull/21054))
- Consider `__len__` when determining the truthiness of an instance of a tuple class or a `@final` class ([#21049](https://github.com/astral-sh/ruff/pull/21049))
- Delegate truthiness inference of an enum `Literal` type to its enum-instance supertype ([#21060](https://github.com/astral-sh/ruff/pull/21060))
- Improve `invalid-argument-type` diagnostics where a union type was provided ([#21044](https://github.com/astral-sh/ruff/pull/21044))

### LSP server

- Suggest `type_check_only` items last in completions ([#20910](https://github.com/astral-sh/ruff/pull/20910))
- Render `import <...>` in completions when "label details" isn't supported ([#21109](https://github.com/astral-sh/ruff/pull/21109))
- Update workspace diagnostic progress every 50ms ([#21019](https://github.com/astral-sh/ruff/pull/21019))

### CLI

- Add `--no-progress` option to suppress the rendering of a progress bar ([#21063](https://github.com/astral-sh/ruff/pull/21063))

### Contributors

- [@ibraheemdev](https://github.com/ibraheemdev)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@BurntSushi](https://github.com/BurntSushi)
- [@mtshiba](https://github.com/mtshiba)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@MichaReiser](https://github.com/MichaReiser)
- [@decorator-factory](https://github.com/decorator-factory)

## 0.0.1-alpha.24

Released on 2025-10-23.

### Breaking changes

- Rename `unknown-rule` lint to `ignore-comment-unknown-rule` ([#20948](https://github.com/astral-sh/ruff/pull/20948))

### Type inference and diagnostics

- Infer a type of `Self` for unannotated `self` parameters in methods ([#20922](https://github.com/astral-sh/ruff/pull/20922))
- Prefer the declared type over the inferred type for invariant collection literals ([#20927](https://github.com/astral-sh/ruff/pull/20927))
- Use declared variable types as bidirectional type context for solving type variables ([#20796](https://github.com/astral-sh/ruff/pull/20796))
- Support `dataclass_transform` for base class models ([#20783](https://github.com/astral-sh/ruff/pull/20783))
- Support dataclass-transform `field_specifiers` ([#20888](https://github.com/astral-sh/ruff/pull/20888))
- `dataclass_transform` support for fields with an `alias` ([#20961](https://github.com/astral-sh/ruff/pull/20961))
- Add support for legacy namespace packages ([#20897](https://github.com/astral-sh/ruff/pull/20897))
- Add suggestion to "unknown rule" diagnostics ([#20948](https://github.com/astral-sh/ruff/pull/20948))
- Improve error messages for "unresolved attribute" diagnostics ([#20963](https://github.com/astral-sh/ruff/pull/20963))
- Avoid unnecessarily widening generic specializations ([#20875](https://github.com/astral-sh/ruff/pull/20875))
- Truncate `Literal` type display in some situations ([#20928](https://github.com/astral-sh/ruff/pull/20928))

### Bug fixes

- Fix panic involving cyclic `TypeVar` default ([#20967](https://github.com/astral-sh/ruff/pull/20967))
- Fix panic involving ever-growing default types ([#20991](https://github.com/astral-sh/ruff/pull/20991))
- Fix panic involving infinitely expanding implicit attribute types ([#20988](https://github.com/astral-sh/ruff/pull/20988))
- Fix autocomplete suggestions when the cursor is at the end of a file ([#20993](https://github.com/astral-sh/ruff/pull/20993))
- Fix inconsistent highlighting of self ([#20986](https://github.com/astral-sh/ruff/pull/20986))
- Fix out-of-order semantic token for function with regular argument after kwargs ([#21013](https://github.com/astral-sh/ruff/pull/21013))
- Fix panic on recursive class definitions in a stub that use constrained type variables ([#20955](https://github.com/astral-sh/ruff/pull/20955))
- Fix panic when attempting to validate the members of a protocol that inherits from a protocol in another module ([#20956](https://github.com/astral-sh/ruff/pull/20956))
- Fix rare hang relating to multithreading ([#21038](https://github.com/astral-sh/ruff/pull/21038))
- Fix non-deterministic overload function inference ([#20966](https://github.com/astral-sh/ruff/pull/20966))
- Fix auto-import edits made by autocompletions for files with an existing `from __future__` import ([#20987](https://github.com/astral-sh/ruff/pull/20987))

### LSP server

- Support goto-definition for binary and unary operators ([#21001](https://github.com/astral-sh/ruff/pull/21001))
- Support goto-definition on vendored typeshed stubs ([#21020](https://github.com/astral-sh/ruff/pull/21020))
- Provide completions on `TypeVar`s ([#20943](https://github.com/astral-sh/ruff/pull/20943))
- Display variance when hovering over type variables ([#20900](https://github.com/astral-sh/ruff/pull/20900))
- Avoid sending an unnecessary "clear diagnostics" message for clients supporting [pull diagnostics](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_pullDiagnostics). ([#20989](https://github.com/astral-sh/ruff/pull/20989))

### Other changes

- Report `continue` and `break` statements outside loops as syntax errors ([#20944](https://github.com/astral-sh/ruff/pull/20944))

### Contributors

- [@TaKO8Ki](https://github.com/TaKO8Ki)
- [@sharkdp](https://github.com/sharkdp)
- [@InvalidPathException](https://github.com/InvalidPathException)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@mtshiba](https://github.com/mtshiba)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@Gankra](https://github.com/Gankra)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.1-alpha.23

Released on 2025-10-16.

### Bug fixes

- Fix handling of dataclass `field()`s without default values ([#20914](https://github.com/astral-sh/ruff/pull/20914))
- Fix false-positive diagnostics on `super()` calls ([#20814](https://github.com/astral-sh/ruff/pull/20814), [#20843](https://github.com/astral-sh/ruff/pull/20843))
- Fix `match` pattern value narrowing to use equality semantics ([#20882](https://github.com/astral-sh/ruff/pull/20882))
- Fix "missing root" panic when handling completion requests ([#20917](https://github.com/astral-sh/ruff/pull/20917))
- Fix overwriting of declared base class attributes through undeclared subclass members ([#20764](https://github.com/astral-sh/ruff/pull/20764))
- Fix runaway execution time for mutually referential instance attributes ([#20645](https://github.com/astral-sh/ruff/pull/20645))

### CLI

- For `unresolved-import` diagnostics, limit the shown import paths to at most five, unless in verbose mode ([#20912](https://github.com/astral-sh/ruff/pull/20912))
- Write files that are slow to type check to log output ([#20836](https://github.com/astral-sh/ruff/pull/20836))
- Remove "pre-release software" warning ([#20817](https://github.com/astral-sh/ruff/pull/20817))

### LSP server

- Improve ranking of autocomplete suggestions ([#20807](https://github.com/astral-sh/ruff/pull/20807))

### Type inference and diagnostics

- Use return type annotations as context for bidirectional type inference ([#20528](https://github.com/astral-sh/ruff/pull/20528))
- Use bidirectional type context for `TypedDict` construction ([#20806](https://github.com/astral-sh/ruff/pull/20806))
- Add support for unpacking of heterogeneous tuples in unions ([#20377](https://github.com/astral-sh/ruff/pull/20377))
- Add a new diagnostic for generic classes that reference typevars from an enclosing scope ([#20822](https://github.com/astral-sh/ruff/pull/20822))
- Add hint when accessing standard library module attributes that are not available on the configured Python version ([#20909](https://github.com/astral-sh/ruff/pull/20909))
- Treat functions, methods, and dynamic types as function-like `Callable`s ([#20842](https://github.com/astral-sh/ruff/pull/20842))
- Treat `Callable`s as bound-method descriptors in special cases ([#20802](https://github.com/astral-sh/ruff/pull/20802))
- Treat `Callable` dunder members as bound method descriptors ([#20860](https://github.com/astral-sh/ruff/pull/20860))
- Sync vendored typeshed stubs ([#20876](https://github.com/astral-sh/ruff/pull/20876)). [Typeshed diff](https://github.com/python/typeshed/compare/91055c730ffcda6311654cf32d663858ece69bad...d6f4a0f7102b1400a21742cf9b7ea93614e2b6ec)

### Performance improvements

- Improve performance by caching union simplification type relations ([#20477](https://github.com/astral-sh/ruff/pull/20477))

### Contributors

- [@mtshiba](https://github.com/mtshiba)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@ericmarkmartin](https://github.com/ericmarkmartin)
- [@carljm](https://github.com/carljm)
- [@ntBre](https://github.com/ntBre)
- [@sharkdp](https://github.com/sharkdp)
- [@BurntSushi](https://github.com/BurntSushi)
- [@Gankra](https://github.com/Gankra)
- [@MichaReiser](https://github.com/MichaReiser)
- [@dcreager](https://github.com/dcreager)

## 0.0.1-alpha.22

Released on 2025-10-10.

### Bug fixes

- Enforce that `typing_extensions` must come from a stdlib search path. This fixes a panic that could occur with a confusing backtrace if the `extra-paths` setting was incorrectly used to point to a virtual environment ([#20715](https://github.com/astral-sh/ruff/pull/20715))
- Fix server panic when opening a project located at `/` in the file system ([#20684](https://github.com/astral-sh/ruff/pull/20684))
- Fix panics when using `--output-format=gitlab` in CI environments ([#20550](https://github.com/astral-sh/ruff/pull/20550))
- Fix stack overflows that could occur when attempting to determine if a recursive `NamedTuple` type was disjoint from another type ([#20538](https://github.com/astral-sh/ruff/pull/20538))
- Fix panics in type inference when legacy TypeVars had bounds, constraints, or defaults that cyclically referred back to the TypeVar definition (directly or indirectly) ([#20598](https://github.com/astral-sh/ruff/pull/20598))
- Fix situations where a panic during resolution of type-checker query cycles would manifest in a hang ([#20577](https://github.com/astral-sh/ruff/pull/20577))
- When analyzing a .py file, do not error if there's also a .pyi for that module ([#20461](https://github.com/astral-sh/ruff/pull/20461))
- Recognise that the runtime object `typing.Protocol` is an instance of `_ProtocolMeta` ([#20488](https://github.com/astral-sh/ruff/pull/20488))
- Fix logic that attempted to determine whether a user had explicitly activated a Conda environment, which has implications for the search paths ty uses for module resolution ([#20675](https://github.com/astral-sh/ruff/pull/20675))
- Fix false negatives when iterables with the wrong type are unpacked into a function with a `*args` variadic parameter ([#20511](https://github.com/astral-sh/ruff/pull/20511))

### Support for Python 3.14

- Use 3.14 as the default version ([#20725](https://github.com/astral-sh/ruff/pull/20725), [#20759](https://github.com/astral-sh/ruff/pull/20759), [#20760](https://github.com/astral-sh/ruff/pull/20760))
- Annotations are deferred by default for 3.14+ ([#20799](https://github.com/astral-sh/ruff/pull/20799))
- Fix false positives when accessing `__annotate__` (Py3.14+) or `__warningregistry__` as a module global ([#20154](https://github.com/astral-sh/ruff/pull/20154))

### Improvements to `TypeVar` solving and inference of generic types

- Improve solving of a type variable `T` if it appears in a union with non-`TypeVar`s (`T | None`, `T | str | None`, etc.) ([#20749](https://github.com/astral-sh/ruff/pull/20749))
- More precise type inference for dictionary literals ([#20523](https://github.com/astral-sh/ruff/pull/20523))
- When solving type variables, use type context to inform whether `Literal` types should be promoted to instance types ([#20776](https://github.com/astral-sh/ruff/pull/20776))
- Use annotated parameters as type context when solving type variables ([#20635](https://github.com/astral-sh/ruff/pull/20635))
- Correctly infer the return type of method calls when the method is annotated as returning `Self` ([#20517](https://github.com/astral-sh/ruff/pull/20517), [#20754](https://github.com/astral-sh/ruff/pull/20754))
- Use type context for inference of generic function calls ([#20476](https://github.com/astral-sh/ruff/pull/20476))
- Use `C[T]` instead of `C[Unknown]` for the upper bound of `Self` ([#20479](https://github.com/astral-sh/ruff/pull/20479))

### Improvements to assignability, subtyping, and union simplification

- Fix overly strict assignability implementation for intersections with negated gradual elements ([#20773](https://github.com/astral-sh/ruff/pull/20773))
- Ensure that `C[Any]` is understood as a subtype of `C[object]` if `C` is a covariant generic class ([#20592](https://github.com/astral-sh/ruff/pull/20592))
- Ensure that `~T` is never considered to be assignable to `T` where `T` is a type variable ([#20606](https://github.com/astral-sh/ruff/pull/20606))
- Improve assignability/subtyping between two protocol types ([#20368](https://github.com/astral-sh/ruff/pull/20368))
- Simplify `Any | (Any & T)` to `Any` ([#20593](https://github.com/astral-sh/ruff/pull/20593))
- Optimise and generalise union/intersection simplification ([#20602](https://github.com/astral-sh/ruff/pull/20602))
- Make protocol satisfiability checks more principled when a protocol has a method member that is generic over type variables scoped to the function ([#20568](https://github.com/astral-sh/ruff/pull/20568))
- Fix subtyping of invariant generics specialized with `Any`, ensuring that (for example) `list[Any]` is not considered a subtype of `list[Any]` ([#20650](https://github.com/astral-sh/ruff/pull/20650))

### Server

- Add LSP debug information command ([#20379](https://github.com/astral-sh/ruff/pull/20379))
- Add support for inlay hints on attribute assignment ([#20485](https://github.com/astral-sh/ruff/pull/20485))

### Improvements to diagnostics

- Improve diagnostics when a positional-only parameter is passed using a keyword argument ([#20495](https://github.com/astral-sh/ruff/pull/20495))
- Improve disambiguations of class names in diagnostics ([#20603](https://github.com/astral-sh/ruff/pull/20603), [#20756](https://github.com/astral-sh/ruff/pull/20756))
- Improve diagnostics for bad `@overload` definitions ([#20745](https://github.com/astral-sh/ruff/pull/20745))
- Truncate type display for long unions in some situations ([#20730](https://github.com/astral-sh/ruff/pull/20730))
- Rename "possibly unbound" diagnostics to "possibly missing" ([#20492](https://github.com/astral-sh/ruff/pull/20492))

### Improvements to enum support

- Allow multiple aliases to point to the same member ([#20669](https://github.com/astral-sh/ruff/pull/20669))
- implement `auto()` for `StrEnum` ([#20524](https://github.com/astral-sh/ruff/pull/20524))

### Improvements to ty's `@overload` implementation

- Support single-starred argument for overload call ([#20223](https://github.com/astral-sh/ruff/pull/20223))
- Filter overloads using variadic parameters ([#20547](https://github.com/astral-sh/ruff/pull/20547))

### Other typing semantics and features

- Do not union the inferred type of a module-global symbol with `Unknown` for the symbol's type when accessed from external scopes ([#20664](https://github.com/astral-sh/ruff/pull/20664))
- Ensure that class objects are understood as callable even if they do not override `object.__new__` or `object.__init__` ([#20521](https://github.com/astral-sh/ruff/pull/20521))
- Add support for `**kwargs` ([#20430](https://github.com/astral-sh/ruff/pull/20430))
- Ensure first-party module-resolution search paths always appear in a sensible order ([#20629](https://github.com/astral-sh/ruff/pull/20629))
- Respect `dataclass_transform` parameters for metaclass-based models ([#20780](https://github.com/astral-sh/ruff/pull/20780))
- Sync vendored typeshed stubs ([#20658](https://github.com/astral-sh/ruff/pull/20658)). [Typeshed diff](https://github.com/python/typeshed/compare/47dbbd6c914a5190d54bc5bd498d1e6633d97db2...91055c730ffcda6311654cf32d663858ece69bad)
- Bring ty's `TypeIs` narrowing behaviour closer to ty's narrowing behaviour for `isinstance()` checks. ([#20591](https://github.com/astral-sh/ruff/pull/20591))
- `dataclass_transform`: Support `frozen_default` and `kw_only_default` ([#20761](https://github.com/astral-sh/ruff/pull/20761))
- Allow any string `Literal` type expression as a key when constructing a `TypedDict` ([#20792](https://github.com/astral-sh/ruff/pull/20792))
- Add `--venv` as an alias to `--python` on the command line ([#20718](https://github.com/astral-sh/ruff/pull/20718))
- Add search paths listed in `PYTHONPATH` to search paths used for ty's module resolution ([#20441](https://github.com/astral-sh/ruff/pull/20441), [#20490](https://github.com/astral-sh/ruff/pull/20490))

### Contributors

- [@thejchap](https://github.com/thejchap)
- [@mtshiba](https://github.com/mtshiba)
- [@Danielkonge](https://github.com/Danielkonge)
- [@dcreager](https://github.com/dcreager)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@Gankra](https://github.com/Gankra)
- [@BurntSushi](https://github.com/BurntSushi)
- [@carljm](https://github.com/carljm)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@sharkdp](https://github.com/sharkdp)
- [@mmlb](https://github.com/mmlb)
- [@fgiacome](https://github.com/fgiacome)
- [@Guillaume-Fgt](https://github.com/Guillaume-Fgt)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@Renkai](https://github.com/Renkai)
- [@InvalidPathException](https://github.com/InvalidPathException)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@fatelei](https://github.com/fatelei)
- [@github-actions](https://github.com/github-actions)
- [@MichaReiser](https://github.com/MichaReiser)
- [@ntBre](https://github.com/ntBre)
- [@danparizher](https://github.com/danparizher)

## 0.0.1-alpha.21

### Bug fixes

- Fix inference of constructor calls to generic classes that have explicitly annotated `self` parameters in their `__init__` methods ([#20325](https://github.com/astral-sh/ruff/pull/20325))
- Fix a stack overflow when computing completions for recursive types ([#20354](https://github.com/astral-sh/ruff/pull/20354))
- Fix panic in `BoundMethodType::into_callable_type()` ([#20369](https://github.com/astral-sh/ruff/pull/20369))
- Fix stack overflows in binary comparison inference ([#20446](https://github.com/astral-sh/ruff/pull/20446))
- Fix many "too many cycle iterations" panics concerning recursive type aliases and/or recursive generics ([#20359](https://github.com/astral-sh/ruff/pull/20359))
- Fix stack overflow involving subtype checks for recursive type aliases ([#20259](https://github.com/astral-sh/ruff/pull/20259))
- Fix panic when inferring the type of an infinitely-nested-tuple implicit instance attribute ([#20333](https://github.com/astral-sh/ruff/pull/20333))

### Server

- Add autocomplete suggestions for unimported symbols ([#20207](https://github.com/astral-sh/ruff/pull/20207), [#20439](https://github.com/astral-sh/ruff/pull/20439))
- Include generated `NamedTuple` methods such as `_make`, `_asdict` and `_replace` in autocomplete suggestions ([#20356](https://github.com/astral-sh/ruff/pull/20356))

### Configuration

- Automatically add `python/` to `environment.root` if a `python/` folder exists in the root of a repository ([#20263](https://github.com/astral-sh/ruff/pull/20263))

### CLI

- Add GitHub output format ([#20358](https://github.com/astral-sh/ruff/pull/20358))
- Add GitLab output format ([#20155](https://github.com/astral-sh/ruff/pull/20155))

### Typing semantics and features

- Add support for generic [PEP-695 type aliases](https://peps.python.org/pep-0695/#generic-type-alias) ([#20219](https://github.com/astral-sh/ruff/pull/20219))
- Allow annotation expressions to be `ast::Attribute` nodes ([#20413](https://github.com/astral-sh/ruff/pull/20413))
- Allow protocols to participate in nominal subtyping as well as structural subtyping ([#20314](https://github.com/astral-sh/ruff/pull/20314))
- Attribute access on top/bottom materializations ([#20221](https://github.com/astral-sh/ruff/pull/20221))
- Bind `Self` type variables to the method, not the class ([#20366](https://github.com/astral-sh/ruff/pull/20366))
- Ensure various special-cased bound methods are understood as assignable to `Callable` ([#20330](https://github.com/astral-sh/ruff/pull/20330))
- Ensure various special-cased builtin functions are understood as assignable to `Callable` ([#20331](https://github.com/astral-sh/ruff/pull/20331))
- Fall back to `object` for attribute access on synthesized protocols ([#20286](https://github.com/astral-sh/ruff/pull/20286))
- Fix signature of `NamedTupleLike._make` ([#20302](https://github.com/astral-sh/ruff/pull/20302))
- Fix subtyping/assignability of function- and class-literal types to callback protocols ([#20363](https://github.com/astral-sh/ruff/pull/20363))
- Implement the legacy PEP-484 convention for indicating positional-only parameters ([#20248](https://github.com/astral-sh/ruff/pull/20248))
- Infer more precise types for collection literals ([#20360](https://github.com/astral-sh/ruff/pull/20360))
- Make `TypeIs` invariant in its type argument ([#20428](https://github.com/astral-sh/ruff/pull/20428))
- Narrow specialized generics using `isinstance()` ([#20256](https://github.com/astral-sh/ruff/pull/20256))
- Proper assignability/subtyping checks for protocols with method members ([#20165](https://github.com/astral-sh/ruff/pull/20165))
- Reduce false positives for `ParamSpec`s and `TypeVarTuple`s ([#20239](https://github.com/astral-sh/ruff/pull/20239))
- Overload evaluation: retry parameter matching for argument type expansion ([#20153](https://github.com/astral-sh/ruff/pull/20153))
- Simplify unions of enum literals and subtypes thereof ([#20324](https://github.com/astral-sh/ruff/pull/20324))
- Support "legacy" `typing.Self` in combination with [PEP-695](https://peps.python.org/pep-0695) generic contexts ([#20304](https://github.com/astral-sh/ruff/pull/20304))
- Treat `Hashable`, and similar protocols, equivalently to `object` for subtyping/assignability ([#20284](https://github.com/astral-sh/ruff/pull/20284))
- Treat `__new__` as a static method ([#20212](https://github.com/astral-sh/ruff/pull/20212))
- `TypedDict`: Add support for `typing.ReadOnly` ([#20241](https://github.com/astral-sh/ruff/pull/20241))
- Detect syntax errors stemming from `yield from` expressions inside async functions ([#20051](https://github.com/astral-sh/ruff/pull/20051))
- `"foo".startswith` is not an instance of `types.MethodWrapperType` ([#20317](https://github.com/astral-sh/ruff/pull/20317))
- Eliminate definitely-impossible types from union in equality narrowing ([#20164](https://github.com/astral-sh/ruff/pull/20164))
- Infer more precise types for the `name` and `value` properties on enum members ([#20311](https://github.com/astral-sh/ruff/pull/20311))
- Initial support for `slots=True` in dataclasses ([#20278](https://github.com/astral-sh/ruff/pull/20278))
- Improve type narrowing in situations involving nested functions ([#19932](https://github.com/astral-sh/ruff/pull/19932))
- Support type aliases in binary comparison inference ([#20445](https://github.com/astral-sh/ruff/pull/20445))
- Sync vendored typeshed stubs ([#20394](https://github.com/astral-sh/ruff/pull/20394)). [Typeshed diff](https://github.com/python/typeshed/compare/2480d7e7c74493a024eaf254c5d2c6f452c80ee2...47dbbd6c914a5190d54bc5bd498d1e6633d97db2)

### Diagnostics

- Improve specialization-error diagnostics ([#20326](https://github.com/astral-sh/ruff/pull/20326))

### Contributors

- [@thejchap](https://github.com/thejchap)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@mtshiba](https://github.com/mtshiba)
- [@JelleZijlstra](https://github.com/JelleZijlstra)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@TaKO8Ki](https://github.com/TaKO8Ki)
- [@Glyphack](https://github.com/Glyphack)
- [@ericmarkmartin](https://github.com/ericmarkmartin)
- [@Renkai](https://github.com/Renkai)
- [@sharkdp](https://github.com/sharkdp)
- [@11happy](https://github.com/11happy)
- [@BurntSushi](https://github.com/BurntSushi)
- [@carljm](https://github.com/carljm)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@github-actions](https://github.com/github-actions)
- [@ntBre](https://github.com/ntBre)

## 0.0.1-alpha.20

### Bug fixes

- Server: Cancel background tasks when shutdown is requested ([#20039](https://github.com/astral-sh/ruff/pull/20039))
- Server: Close signature help after `)` ([#20017](https://github.com/astral-sh/ruff/pull/20017))
- Server: Fix incorrect docstring in call signature completion ([#20021](https://github.com/astral-sh/ruff/pull/20021))
- Fix 'too many cycle iterations' for unions of literals ([#20137](https://github.com/astral-sh/ruff/pull/20137))
- Fix namespace packages that behave like partial stubs ([#19994](https://github.com/astral-sh/ruff/pull/19994))
- Fix server hang (unchanged diagnostics) when changing file on Windows ([#19991](https://github.com/astral-sh/ruff/pull/19991))
- Apply `KW_ONLY` sentinel only to local fields ([#19986](https://github.com/astral-sh/ruff/pull/19986))
- Ignore field specifiers when not specified in `@dataclass_transform` ([#20002](https://github.com/astral-sh/ruff/pull/20002))

### Server

- Add completion support for `import` and `from ... import` statements ([#19883](https://github.com/astral-sh/ruff/pull/19883))
- Add type as detail to completion items ([#20047](https://github.com/astral-sh/ruff/pull/20047))
- Ask the LSP client to watch all project search paths ([#19975](https://github.com/astral-sh/ruff/pull/19975))
- Fix incorrect inlay hint type ([#20044](https://github.com/astral-sh/ruff/pull/20044))
- Update goto definition, goto declaration and hover to consider constructor method (`__init__`) ([#20014](https://github.com/astral-sh/ruff/pull/20014))
- Add docstrings to completions based on type ([#20008](https://github.com/astral-sh/ruff/pull/20008))
- Fix goto targets for keyword arguments in nested function calls ([#20013](https://github.com/astral-sh/ruff/pull/20013))
- Introduce multiline pretty printer to render function signatures across multiple lines ([#19979](https://github.com/astral-sh/ruff/pull/19979))

### Configuration

- Distinguish base conda from child conda ([#19990](https://github.com/astral-sh/ruff/pull/19990))

### Typing semantics and features

- Add support for PEP 750: t-strings ([#20085](https://github.com/astral-sh/ruff/pull/20085))
- Add support for PEP 800: Disjoint bases ([#20084](https://github.com/astral-sh/ruff/pull/20084))
- Add precise inference for unpacking a TypeVar if the TypeVar has an upper bound with a precise tuple spec ([#19985](https://github.com/astral-sh/ruff/pull/19985))
- Add precise iteration and unpacking inference for string literals and bytes literals ([#20023](https://github.com/astral-sh/ruff/pull/20023))
- Completely ignore typeshed's stub for `Any` ([#20079](https://github.com/astral-sh/ruff/pull/20079))
- Enforce that an attribute on a class `X` must be callable in order to satisfy a member on a protocol `P` ([#20142](https://github.com/astral-sh/ruff/pull/20142))
- Evaluate static truthiness of non-definitely-bound symbols to "ambiguous" ([#19579](https://github.com/astral-sh/ruff/pull/19579))
- Fix the inferred interface of specialized generic protocols ([#19866](https://github.com/astral-sh/ruff/pull/19866))
- Infer slightly more precise types for comprehensions ([#20111](https://github.com/astral-sh/ruff/pull/20111))
- Disable boundness analysis for implicit instance attributes ([#20128](https://github.com/astral-sh/ruff/pull/20128))
- Add `Top[]` and `Bottom[]` special forms ([#20054](https://github.com/astral-sh/ruff/pull/20054))
- Preserve qualifiers when accessing attributes on unions/intersections ([#20114](https://github.com/astral-sh/ruff/pull/20114))
- Strict validation of protocol members ([#17750](https://github.com/astral-sh/ruff/pull/17750))
- Support `__init_subclass__` ([#20190](https://github.com/astral-sh/ruff/pull/20190))
- Unpack variadic argument type in specialization ([#20130](https://github.com/astral-sh/ruff/pull/20130))
- Use `invalid-assignment` error code for invalid assignments to `ClassVar`s ([#20156](https://github.com/astral-sh/ruff/pull/20156))
- Use specialized parameter type for overload filter ([#19964](https://github.com/astral-sh/ruff/pull/19964))
- `__class_getitem__` is a classmethod ([#20192](https://github.com/astral-sh/ruff/pull/20192))
- Add cycle detection for find_legacy_typevars ([#20124](https://github.com/astral-sh/ruff/pull/20124))
- Add support for cyclic legacy generic protocols ([#20125](https://github.com/astral-sh/ruff/pull/20125))
- Don't eagerly unpack aliases in user-authored unions ([#20055](https://github.com/astral-sh/ruff/pull/20055))
- Don't mark entire type-alias scopes as Deferred ([#20086](https://github.com/astral-sh/ruff/pull/20086))
- Ensure union normalization really normalizes ([#20147](https://github.com/astral-sh/ruff/pull/20147))
- Improve cycle-detection coverage for apply_type_mapping ([#20159](https://github.com/astral-sh/ruff/pull/20159))
- Linear variance inference for PEP-695 type parameters ([#18713](https://github.com/astral-sh/ruff/pull/18713))
- Minor `TypedDict` fixes ([#20146](https://github.com/astral-sh/ruff/pull/20146))
- Typecheck dict methods for `TypedDict` ([#19874](https://github.com/astral-sh/ruff/pull/19874))
- Validate constructor call of `TypedDict` ([#19810](https://github.com/astral-sh/ruff/pull/19810))
- Sync vendored typeshed stubs ([#20031](https://github.com/astral-sh/ruff/pull/20031), [#20083](https://github.com/astral-sh/ruff/pull/20083), [#20188](https://github.com/astral-sh/ruff/pull/20188)) [Typeshed diff](https://github.com/python/typeshed/compare/893b9a760deb3be64d13c748318e95a752230961...2480d7e7c74493a024eaf254c5d2c6f452c80ee2)

### Diagnostics

- Add search paths info to unresolved import diagnostics ([#20040](https://github.com/astral-sh/ruff/pull/20040))
- Better error message for attempting to assign to a read-only property ([#20150](https://github.com/astral-sh/ruff/pull/20150))
- Improve diagnostics for bad calls to functions ([#20022](https://github.com/astral-sh/ruff/pull/20022))
- Improve disambiguation of types via fully qualified names ([#20141](https://github.com/astral-sh/ruff/pull/20141))
- Print diagnostics with fully qualified name to disambiguate some cases ([#19850](https://github.com/astral-sh/ruff/pull/19850))

### Performance

- Avoid unnecessary argument type expansion ([#19999](https://github.com/astral-sh/ruff/pull/19999))
- Limit argument expansion size for overload call evaluation ([#20041](https://github.com/astral-sh/ruff/pull/20041))
- Optimize TDD atom ordering ([#20098](https://github.com/astral-sh/ruff/pull/20098))

### Contributors

- [@carljm](https://github.com/carljm)
- [@sharkdp](https://github.com/sharkdp)
- [@dylwil3](https://github.com/dylwil3)
- [@dcreager](https://github.com/dcreager)
- [@MichaReiser](https://github.com/MichaReiser)
- [@ericmarkmartin](https://github.com/ericmarkmartin)
- [@Renkai](https://github.com/Renkai)
- [@JelleZijlstra](https://github.com/JelleZijlstra)
- [@BurntSushi](https://github.com/BurntSushi)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@github-actions](https://github.com/github-actions)
- [@PrettyWood](https://github.com/PrettyWood)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@Glyphack](https://github.com/Glyphack)
- [@Gankra](https://github.com/Gankra)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@leandrobbraga](https://github.com/leandrobbraga)

## 0.0.1-alpha.19

### Bug fixes

- Fix false-positive diagnostics if a function parameter is annotated with `type[P]` where `P` is a protocol class ([#19947](https://github.com/astral-sh/ruff/pull/19947))
- Fix ANSI colors in terminal output on old Windows terminals ([#19984](https://github.com/astral-sh/ruff/pull/19984))
- Fix protocol interface inference for protocols in stub files with `ClassVar` members and "subprotocols" that extend other protocols ([#19950](https://github.com/astral-sh/ruff/pull/19950))
- Fix inference of equality comparisons between enum members ([#19666](https://github.com/astral-sh/ruff/pull/19666))
- Remove incorrect type narrowing for `if type(x) is C[int]` ([#19926](https://github.com/astral-sh/ruff/pull/19926))
- Improve detection of `TypeError`s resulting from protocol classes illegally inheriting from non-protocol classes ([#19941](https://github.com/astral-sh/ruff/pull/19941)). We previously detected this error, but only when the protocol class illegally inherited from a non-generic class or an unspecialized generic class. We now also detect it when the protocol class inherits from a specialized generic class.
- Fix incorrectly precise type inference in some situations involving nested scopes ([#19908](https://github.com/astral-sh/ruff/pull/19908))
- Fix unpacking a type alias with a precise tuple spec ([#19981](https://github.com/astral-sh/ruff/pull/19981))

### `NamedTuple` semantics improvements

- Synthesize read-only properties for all declared members on `NamedTuple` classes ([#19899](https://github.com/astral-sh/ruff/pull/19899))
- Allow any instance of a `NamedTuple` class to be passed to a function parameter annotated with `typing.NamedTuple` ([#19915](https://github.com/astral-sh/ruff/pull/19915))
- Detect `NamedTuple` classes where fields without default values illegally follow fields with default values ([#19945](https://github.com/astral-sh/ruff/pull/19945)). This causes `TypeError` to be raised at runtime.
- Detect illegal multiple inheritance with `NamedTuple` ([#19943](https://github.com/astral-sh/ruff/pull/19943)). This causes `TypeError` to be raised at runtime.

### Other typing and semantics improvements

- Add support for stubs packages with `partial` in their `py.typed` files ([#19931](https://github.com/astral-sh/ruff/pull/19931))
- Look for `site-packages` directories in `<sys.prefix>/lib64/` as well as `<sys.prefix>/lib/` on non-Windows systems ([#19978](https://github.com/astral-sh/ruff/pull/19978)). This change fixes a number of `unresolved-import` false-positive diagnostics reported by Poetry users.
- Add diagnostics for invalid `await` expressions ([#19711](https://github.com/astral-sh/ruff/pull/19711))
- Add `else`-branch narrowing for `if type(a) is A` when `A` is `@final` ([#19925](https://github.com/astral-sh/ruff/pull/19925))
- Improve solving of typevars with defaults, and `typing.Self` ([#19786](https://github.com/astral-sh/ruff/pull/19786))
- Support the `kw_only` parameter for `dataclasses.dataclass()` and `dataclasses.field()` ([#19677](https://github.com/astral-sh/ruff/pull/19677))
- Sync vendored typeshed stubs ([#19923](https://github.com/astral-sh/ruff/pull/19923)). [Typeshed diff](https://github.com/python/typeshed/compare/3f08a4ed10b321c378107c236a06a33584869a9b...893b9a760deb3be64d13c748318e95a752230961).

### Server improvements

- Improve goto/hover for definitions ([#19976](https://github.com/astral-sh/ruff/pull/19976))

### Performance improvements

- Short-circuit a server [inlay hints request](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_inlayHint) if all settings under `ty.inlayHints` are disabled ([#19963](https://github.com/astral-sh/ruff/pull/19963))
- Speedup server tracing checks ([#19965](https://github.com/astral-sh/ruff/pull/19965))
- Add caching to logic for inferring whether a class is a `NamedTuple`, a dataclass or a `TypedDict` ([#19912](https://github.com/astral-sh/ruff/pull/19912))
- Speedup project file discovery ([#19913](https://github.com/astral-sh/ruff/pull/19913))

### Contributors

- [@dcreager](https://github.com/dcreager)
- [@MichaReiser](https://github.com/MichaReiser)
- [@sharkdp](https://github.com/sharkdp)
- [@github-actions](https://github.com/github-actions)
- [@mtshiba](https://github.com/mtshiba)
- [@theammir](https://github.com/theammir)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@thejchap](https://github.com/thejchap)
- [@Gankra](https://github.com/Gankra)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@carljm](https://github.com/carljm)

## 0.0.1-alpha.18

### Bug fixes

- Fix goto definition on imports ([#19834](https://github.com/astral-sh/ruff/pull/19834))
- Support non-generic recursive type aliases that use [the `type` statement](https://docs.python.org/3/reference/simple_stmts.html#grammar-token-python-grammar-type_stmt) ([#19805](https://github.com/astral-sh/ruff/pull/19805))
- Handle cycles when finding implicit attributes ([#19833](https://github.com/astral-sh/ruff/pull/19833))

### Server

- Implement support for "rename" language server feature ([#19551](https://github.com/astral-sh/ruff/pull/19551))
- Add `ty.experimental.rename` server setting ([#19800](https://github.com/astral-sh/ruff/pull/19800))
- Add `ty.inlayHints.variableTypes` server setting ([#19780](https://github.com/astral-sh/ruff/pull/19780))
- Add inlay hints for call arguments (configured by `ty.inlayHints.callArgumentNames` server setting) ([#19269](https://github.com/astral-sh/ruff/pull/19269))
- Enable goto definition to jump to the runtime definition in the standard library for stdlib symbols (rather than the type definition in typeshed's stubs) ([#19529](https://github.com/astral-sh/ruff/pull/19529))
- Support LSP client settings ([#19614](https://github.com/astral-sh/ruff/pull/19614))
- Update goto range for attribute access to only target the attribute ([#19848](https://github.com/astral-sh/ruff/pull/19848))
- Warn users if the server received unknown options ([#19779](https://github.com/astral-sh/ruff/pull/19779))
- Render docstrings in hover ([#19882](https://github.com/astral-sh/ruff/pull/19882))
- Resolve docstrings for modules ([#19898](https://github.com/astral-sh/ruff/pull/19898))

### Typing semantics and features

- Add precise inference for indexing, slicing and unpacking `NamedTuple` instances ([#19560](https://github.com/astral-sh/ruff/pull/19560))
- Disallow `typing.TypedDict` in type expressions ([#19777](https://github.com/astral-sh/ruff/pull/19777))
- Implement module-level `__getattr__` support ([#19791](https://github.com/astral-sh/ruff/pull/19791))
- Improve ability to solve TypeVars when they appear in unions ([#19829](https://github.com/astral-sh/ruff/pull/19829))
- Improve subscript narrowing for `collections.ChainMap`, `collections.Counter`, `collections.deque` and `collections.OrderedDict` ([#19781](https://github.com/astral-sh/ruff/pull/19781))
- Extend all tuple special casing to tuple subclasses ([#19669](https://github.com/astral-sh/ruff/pull/19669))
- Use separate Rust types for bound and unbound type variables ([#19796](https://github.com/astral-sh/ruff/pull/19796))
- Validate writes to `TypedDict` keys ([#19782](https://github.com/astral-sh/ruff/pull/19782))
- `typing.Self` is bound by the method, not the class ([#19784](https://github.com/astral-sh/ruff/pull/19784))
- Fix deferred name loading in PEP695 generic classes/functions ([#19888](https://github.com/astral-sh/ruff/pull/19888))
- Improve handling of symbol-lookup edge cases involving class scopes ([#19795](https://github.com/astral-sh/ruff/pull/19795))

### Performance

- Improve performance around tuple types ([#19840](https://github.com/astral-sh/ruff/pull/19840))
- Improve performance of subtyping and assignability checks for protocols ([#19824](https://github.com/astral-sh/ruff/pull/19824))
- Improve multithreaded performance for large codebases ([#19867](https://github.com/astral-sh/ruff/pull/19867))

### Memory usage optimizations

- Reduce memory usage of `TupleSpec` and `TupleType` ([#19872](https://github.com/astral-sh/ruff/pull/19872))
- Reduce size of member table ([#19572](https://github.com/astral-sh/ruff/pull/19572))

### Contributors

- [@AlexWaygood](https://github.com/AlexWaygood)
- [@Gankra](https://github.com/Gankra)
- [@ntbre](https://github.com/ntBre)
- [@MichaReiser](https://github.com/MichaReiser)
- [@PrettyWood](https://github.com/PrettyWood)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@carljm](https://github.com/carljm)
- [@dcreager](https://github.com/dcreager)
- [@UnboundVariable](https://github.com/UnboundVariable)
- [@sharkdp](https://github.com/sharkdp)
- [@oconnor663](https://github.com/oconnor663)
- [@MatthewMckee4](https://github.com/MatthewMckee4)

## 0.0.1-alpha.17

### Bug fixes

- Always refresh diagnostics after a watched files change ([#19697](https://github.com/astral-sh/ruff/pull/19697))
- Correctly instantiate generic class that inherits `__init__` from generic base class ([#19693](https://github.com/astral-sh/ruff/pull/19693))
- Don't panic with argument that doesn't actually implement Iterable ([#19602](https://github.com/astral-sh/ruff/pull/19602))
- Fix "peek definition" in playground ([#19592](https://github.com/astral-sh/ruff/pull/19592))
- Fix empty spans following a line terminator and unprintable character spans in diagnostics ([#19535](https://github.com/astral-sh/ruff/pull/19535))
- Fix incorrect diagnostic when calling `__setitem__` ([#19645](https://github.com/astral-sh/ruff/pull/19645))
- Fix lookup order of class variables before they are defined ([#19743](https://github.com/astral-sh/ruff/pull/19743))
- Fix more false positives related to `Generic` or `Protocol` being subscripted with a `ParamSpec` or `TypeVarTuple` ([#19764](https://github.com/astral-sh/ruff/pull/19764))
- Keep track of type qualifiers in stub declarations without right-hand side ([#19756](https://github.com/astral-sh/ruff/pull/19756))

### Server

- Add progress reporting to workspace diagnostics ([#19616](https://github.com/astral-sh/ruff/pull/19616))
- Add stub mapping support to signature help ([#19570](https://github.com/astral-sh/ruff/pull/19570))
- Added support for "document symbols" and "workspace symbols" ([#19521](https://github.com/astral-sh/ruff/pull/19521))
- Fix server panic in workspace diagnostics request handler when typing ([#19631](https://github.com/astral-sh/ruff/pull/19631))
- Implement caching for workspace and document diagnostics ([#19605](https://github.com/astral-sh/ruff/pull/19605))
- Implement long-polling for workspace diagnostics ([#19670](https://github.com/astral-sh/ruff/pull/19670))
- Implement streaming for workspace diagnostics ([#19657](https://github.com/astral-sh/ruff/pull/19657))
- Implemented support for "selection range" language server feature ([#19567](https://github.com/astral-sh/ruff/pull/19567))

### CLI

- Add progress bar to `--watch` mode ([#19729](https://github.com/astral-sh/ruff/pull/19729))
- Clear the terminal screen in `--watch` mode ([#19712](https://github.com/astral-sh/ruff/pull/19712))
- Resolve file symlinks in src walk ([#19674](https://github.com/astral-sh/ruff/pull/19674))

### Typing semantics and features

- Support `async`/`await`, `async with` and `yield from` ([#19595](https://github.com/astral-sh/ruff/pull/19595))
- Add support for `async for` loops and async iterables ([#19634](https://github.com/astral-sh/ruff/pull/19634))
- Don't include already-bound legacy typevars in function generic context ([#19558](https://github.com/astral-sh/ruff/pull/19558))
- Infer types for key-based access on `TypedDict`s ([#19763](https://github.com/astral-sh/ruff/pull/19763))
- Improve `isinstance()` truthiness analysis for generic types ([#19668](https://github.com/astral-sh/ruff/pull/19668))
- Infer `type[tuple[int, str]]` as the meta-type of `tuple[int, str]` ([#19741](https://github.com/astral-sh/ruff/pull/19741))
- Remove false positives when subscripting `Generic` or `Protocol` with a `ParamSpec` or `TypeVarTuple` ([#19749](https://github.com/astral-sh/ruff/pull/19749))
- Remove special casing for string-literal-in-tuple `__contains__` ([#19642](https://github.com/astral-sh/ruff/pull/19642))
- Remove special casing for tuple addition ([#19636](https://github.com/astral-sh/ruff/pull/19636))
- Return `Option<TupleType>` from `infer_tuple_type_expression` ([#19735](https://github.com/astral-sh/ruff/pull/19735))
- Support `as`-patterns in reachability analysis ([#19728](https://github.com/astral-sh/ruff/pull/19728))
- Support `__setitem__` and improve `__getitem__` related diagnostics ([#19578](https://github.com/astral-sh/ruff/pull/19578))
- Synthesize precise `__getitem__` overloads for tuple subclasses ([#19493](https://github.com/astral-sh/ruff/pull/19493))
- Track different uses of legacy typevars, including context when rendering typevars ([#19604](https://github.com/astral-sh/ruff/pull/19604))
- Upcast heterogeneous and mixed tuples to homogeneous tuples where it's necessary to solve a `TypeVar` ([#19635](https://github.com/astral-sh/ruff/pull/19635))
- Fix incorrect lazy scope narrowing ([#19744](https://github.com/astral-sh/ruff/pull/19744))
- Synthesize `__replace__` for dataclasses ([#19545](https://github.com/astral-sh/ruff/pull/19545))

### Diagnostics

- Add diagnostics for async context managers ([#19704](https://github.com/astral-sh/ruff/pull/19704))
- Display generic function signature properly ([#19544](https://github.com/astral-sh/ruff/pull/19544))
- Improve the `Display` for generic `type[]` types ([#19667](https://github.com/astral-sh/ruff/pull/19667))
- Remap Jupyter notebook cell indices in `ruff_db` ([#19698](https://github.com/astral-sh/ruff/pull/19698))

### Documentation

- Add the `ty` badge ([#897](https://github.com/astral-sh/ty/pull/897))

### Contributors

- [@mtshiba](https://github.com/mtshiba)
- [@MichaReiser](https://github.com/MichaReiser)
- [@sharkdp](https://github.com/sharkdp)
- [@github-actions](https://github.com/github-actions)
- [@UnboundVariable](https://github.com/UnboundVariable)
- [@jorenham](https://github.com/jorenham)
- [@silamon](https://github.com/silamon)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@thejchap](https://github.com/thejchap)
- [@ngroman](https://github.com/ngroman)
- [@leandrobbraga](https://github.com/leandrobbraga)
- [@dcreager](https://github.com/dcreager)
- [@ntbre](https://github.com/ntBre)
- [@MatthewMckee4](https://github.com/MatthewMckee4)

## 0.0.1-alpha.16

### Bug fixes

- Fix server panics when hovering over invalid syntax in `Callable` annotations ([#19517](https://github.com/astral-sh/ruff/pull/19517))
- `match` statements: Fix narrowing and reachability of class patterns with arguments ([#19512](https://github.com/astral-sh/ruff/pull/19512))
- Fix server panics when hovering over illegal `Literal[…]` annotations with inner subscript expressions ([#19489](https://github.com/astral-sh/ruff/pull/19489))
- Pass down specialization to generic dataclass bases ([#19472](https://github.com/astral-sh/ruff/pull/19472))

### Server

- Add support for "go to definition" for attribute accesses and keyword arguments ([#19417](https://github.com/astral-sh/ruff/pull/19417))
- Add support for "go to definition" for import statements ([#19428](https://github.com/astral-sh/ruff/pull/19428))
- Add support for "document highlights" ([#19515](https://github.com/astral-sh/ruff/pull/19515))
- Add partial support for "find references" ([#19475](https://github.com/astral-sh/ruff/pull/19475))
- Prefer the runtime definition, not the stub definition, on a go-to-definition request for a class or function. Currently this is only implemented for definitions originating outside of the stdlib. ([#19471](https://github.com/astral-sh/ruff/pull/19471))
- Add [semantic token](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_semanticTokens) support for more identifiers ([#19473](https://github.com/astral-sh/ruff/pull/19473))
- Avoid rechecking the entire project when a file in the editor is opened or closed ([#19463](https://github.com/astral-sh/ruff/pull/19463))

### Typing semantics and features

- Handle splatted arguments in function calls ([#18996](https://github.com/astral-sh/ruff/pull/18996))
- Improve place lookup and narrowing in lazy scopes ([#19321](https://github.com/astral-sh/ruff/pull/19321))
- Add exhaustiveness checking and reachability analysis for `match` statements ([#19508](https://github.com/astral-sh/ruff/pull/19508))
- Improve reachability analysis for `isinstance(…)` branches ([#19503](https://github.com/astral-sh/ruff/pull/19503))
- Make tuple subclass constructors sound ([#19469](https://github.com/astral-sh/ruff/pull/19469))
- Extend tuple `__len__` and `__bool__` special casing to also cover tuple subclasses ([#19289](https://github.com/astral-sh/ruff/pull/19289))
- Add support for `dataclasses.field` ([#19553](https://github.com/astral-sh/ruff/pull/19553))
- Add support for `dataclasses.InitVar` ([#19527](https://github.com/astral-sh/ruff/pull/19527))
- Add support for `@warnings.deprecated` and `typing_extensions.deprecated` ([#19376](https://github.com/astral-sh/ruff/pull/19376))
- Do not consider a type `T` to satisfy a method member on a protocol unless the method is available on the meta-type of `T` ([#19187](https://github.com/astral-sh/ruff/pull/19187))
- Implement expansion of enums into unions of literals ([#19382](https://github.com/astral-sh/ruff/pull/19382))
- Support iterating over enums ([#19486](https://github.com/astral-sh/ruff/pull/19486))
- Detect enums if metaclass is a subtype of `EnumType` / `EnumMeta` ([#19481](https://github.com/astral-sh/ruff/pull/19481))
- Infer single-valuedness for enums deriving from `int` or `str` ([#19510](https://github.com/astral-sh/ruff/pull/19510))
- Detect illegal non-enum attribute accesses in `Literal` annotations ([#19477](https://github.com/astral-sh/ruff/pull/19477))
- Disallow assignment to `Final` class attributes ([#19457](https://github.com/astral-sh/ruff/pull/19457))
- Handle implicit instance attributes declared `Final` ([#19462](https://github.com/astral-sh/ruff/pull/19462))
- Disallow `Final` in function parameter- and return-type annotations ([#19480](https://github.com/astral-sh/ruff/pull/19480))
- Disallow illegal uses of `ClassVar` ([#19483](https://github.com/astral-sh/ruff/pull/19483))
- Make `del x` force a local resolution of `x` in the current scope ([#19389](https://github.com/astral-sh/ruff/pull/19389))
- Perform type narrowing for places marked `global` ([#19381](https://github.com/astral-sh/ruff/pull/19381))
- Infer correct types for attribute accesses on intersections with negative parts ([#19524](https://github.com/astral-sh/ruff/pull/19524))
- Sync vendored typeshed stubs ([typeshed diff](https://github.com/python/typeshed/compare/84e41f2853d7af3d651d620f093031cba849bd1d...08225953c98cfd375d80bc88865e5aae77d2c07f)). [Typeshed diff](https://github.com/python/typeshed/compare/843c1fd5a148da85e523c1b4ee680226f89986aa...f8f0794d0fe249c06dc9f31a004d85be6cca6ced)

### Memory usage optimizations

- Reduce ty's memory usage (for example: [#19409](https://github.com/astral-sh/ruff/pull/19409), [#19435](https://github.com/astral-sh/ruff/pull/19435), [#19414](https://github.com/astral-sh/ruff/pull/19414))

### Contributors

- [@sharkdp](https://github.com/sharkdp)
- [@BurntSushi](https://github.com/BurntSushi)
- [@oconnor663](https://github.com/oconnor663)
- [@Gankra](https://github.com/Gankra)
- [@carljm](https://github.com/carljm)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@MichaReiser](https://github.com/MichaReiser)
- [@dcreager](https://github.com/dcreager)
- [@mtshiba](https://github.com/mtshiba)
- [@UnboundVariable](https://github.com/UnboundVariable)

## 0.0.1-alpha.15

### Bug fixes

- Avoid stale diagnostics for open-files diagnostic mode ([#19273](https://github.com/astral-sh/ruff/pull/19273))
- Fix inconsistent semantic syntax highlighting for parameters ([#19418](https://github.com/astral-sh/ruff/pull/19418))
- Fix checking of virtual files after re-opening from an unsaved edit ([#19277](https://github.com/astral-sh/ruff/pull/19277))
- Show the correct ty version in the LSP server ([#19284](https://github.com/astral-sh/ruff/pull/19284))
- Do not surface settings errors in unrelated Python files ([#19206](https://github.com/astral-sh/ruff/pull/19206))
- Do not ignore conditionally defined dataclass fields ([#19197](https://github.com/astral-sh/ruff/pull/19197))
- Fix panic for attribute expressions with empty value ([#19069](https://github.com/astral-sh/ruff/pull/19069))
- Fix assignabiliy of dataclasses to `Callable` types ([#19192](https://github.com/astral-sh/ruff/pull/19192))
- Fix `__setattr__` call check precedence during attribute assignment ([#18347](https://github.com/astral-sh/ruff/pull/18347))

### Server

- Add definition and declaration providers (go-to-definition, go-to-declaration) ([#19371](https://github.com/astral-sh/ruff/pull/19371))
- Add signature help provider (show signature and docstring when writing a call expression) ([#19194](https://github.com/astral-sh/ruff/pull/19194))
- Add "kind" to completion suggestions ([#19216](https://github.com/astral-sh/ruff/pull/19216))
- Add completions for submodules that aren't attributes of their parent ([#19266](https://github.com/astral-sh/ruff/pull/19266))
- Filter out private type aliases from stub files when offering autocomplete suggestions ([#19282](https://github.com/astral-sh/ruff/pull/19282))
- Handle configuration errors in the LSP more gracefully ([#19262](https://github.com/astral-sh/ruff/pull/19262))
- Use Python version and path from VSCode Python extension ([#19012](https://github.com/astral-sh/ruff/pull/19012))
- Publish errors in settings as LSP diagnostics ([#19335](https://github.com/astral-sh/ruff/pull/19335))

### Typing semantics and features

- Add support for `nonlocal` statements ([#19112](https://github.com/astral-sh/ruff/pull/19112))
- Support empty function bodies in `if TYPE_CHECKING` blocks ([#19372](https://github.com/astral-sh/ruff/pull/19372))
- Emit a diagnostic when attempting to modify a `typing.Final`-qualified symbol ([#19178](https://github.com/astral-sh/ruff/pull/19178))
- Infer enum literal types when accessing enum members ([#19328](https://github.com/astral-sh/ruff/pull/19328))
- Synthesize `__setattr__` for frozen dataclasses ([#19307](https://github.com/astral-sh/ruff/pull/19307))
- Improve equivalence for module-literal types ([#19243](https://github.com/astral-sh/ruff/pull/19243))
- Reduce false positives for `TypedDict` types ([#19354](https://github.com/astral-sh/ruff/pull/19354))
- Emit an error for `global` uses if there is no explicit definition in the global scope ([#19344](https://github.com/astral-sh/ruff/pull/19344))
- Sync vendored typeshed stubs ([typeshed diff](https://github.com/python/typeshed/compare/f64707592dd3c32f756ddeebd012acb2b072aa0d...84e41f2853d7af3d651d620f093031cba849bd1d)). [Typeshed diff](https://github.com/python/typeshed/compare/843c1fd5a148da85e523c1b4ee680226f89986aa...f8f0794d0fe249c06dc9f31a004d85be6cca6ced)

### CLI

- Add a `-q`/`--quiet` mode, `-qq` for silent output mode ([#19233](https://github.com/astral-sh/ruff/pull/19233))

### Contributors

- [@AlexWaygood](https://github.com/AlexWaygood)
- [@github-actions](https://github.com/github-actions)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@sharkdp](https://github.com/sharkdp)
- [@renovate](https://github.com/renovate)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@UnboundVariable](https://github.com/UnboundVariable)
- [@oconnor663](https://github.com/oconnor663)
- [@zanieb](https://github.com/zanieb)
- [@MichaReiser](https://github.com/MichaReiser)
- [@charliermarsh](https://github.com/charliermarsh)
- [@Gankra](https://github.com/Gankra)
- [@thejchap](https://github.com/thejchap)
- [@BurntSushi](https://github.com/BurntSushi)
- [@mdqst](https://github.com/mdqst)

## 0.0.1-alpha.14

### Bug fixes

- Add cycle detection to ty's implementation of disjointness between types, fixing a possible source of stack overflows when analysing recursive types ([#19139](https://github.com/astral-sh/ruff/pull/19139))
- Don't allow first-party code to shadow the stdlib `types` module ([#19128](https://github.com/astral-sh/ruff/pull/19128)).
    This fixes another possible source of stack overflows.
- Fix descriptor lookups for most types that overlap with `None` ([#19120](https://github.com/astral-sh/ruff/pull/19120)).
    This means that e.g. `object().__str__()` now correctly binds the `self` argument of the `__str__`
    method, as the `object` type overlaps with `None`.

### Server

- Filter a symbol from a stub file in autocomplete suggestions if it is an implementation detail of the stub ([#19121](https://github.com/astral-sh/ruff/pull/19121))
- Add initial support for [semantic tokens](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_semanticTokens) ([#19108](https://github.com/astral-sh/ruff/pull/19108)).
    This feature allows editors to apply more advanced syntax highlighting. Currently, the supported tokens are: `Namespace`, `Class`, `Parameter`, `SelfParameter`,`ClsParameter`, `Variable`, `Property`, `Function`, `Method`, `Keyword`, `String`, `Number`, `Decorator`, `BuiltinConstant` and `TypeParameter`.
- Initial support for [workspace diagnostics](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#workspace_diagnostic) ([#18939](https://github.com/astral-sh/ruff/pull/18939)).
    Enable this feature by setting the `ty.diagnosticMode` configuration setting to `"workspace"`.
- Use Python syntax highlighting in on-hover content ([#19082](https://github.com/astral-sh/ruff/pull/19082))

### Typing semantics and features

- Understand that calls to functions returning `Never` / `NoReturn` are terminal with respect to control flow ([#18333](https://github.com/astral-sh/ruff/pull/18333))
- Add subtyping between `type[]` types and `Callable` types ([#19026](https://github.com/astral-sh/ruff/pull/19026))
- Support bare `ClassVar` annotations ([#15768](https://github.com/astral-sh/ruff/pull/15768))
- Understand that two protocols with equivalent method members are equivalent ([#18659](https://github.com/astral-sh/ruff/pull/18659))
- Support declared-only instance attributes such as `self.x: int` ([#19048](https://github.com/astral-sh/ruff/pull/19048))
- Sync vendored typeshed stubs ([#19174](https://github.com/astral-sh/ruff/pull/19174)): [typeshed diff](https://github.com/python/typeshed/compare/3f727b0cd6620b7fca45318dd34542b1e1c7dbfb...f64707592dd3c32f756ddeebd012acb2b072aa0d)
- Use the inferred type as the declared type for bare `Final` symbols ([#19142](https://github.com/astral-sh/ruff/pull/19142))

### Contributors

- [@iyakushev](https://github.com/iyakushev)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@zanieb](https://github.com/zanieb)
- [@sharkdp](https://github.com/sharkdp)
- [@UnboundVariable](https://github.com/UnboundVariable)
- [@abhijeetbodas2001](https://github.com/abhijeetbodas2001)
- [@github-actions](https://github.com/github-actions)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@carljm](https://github.com/carljm)
- [@CodeMan62](https://github.com/CodeMan62)

## 0.0.1-alpha.13

### Bug fixes

- Fix stack overflows related to mutually recursive protocols ([#19003](https://github.com/astral-sh/ruff/pull/19003))
- Don't add incorrect subdiagnostic for `unresolved-reference` in `staticmethod`s and `classmethod`s ([#18487](https://github.com/astral-sh/ruff/pull/18487))
- Fix rendering of long lines in diagnostic messages that are indented with tabs ([#18962](https://github.com/astral-sh/ruff/pull/18962))
- Fix reachability of star import definitions for nonlocal lookups ([#19066](https://github.com/astral-sh/ruff/pull/19066))

### Typing semantics and features

- Support variable-length tuples in unpacking assignments ([#18948](https://github.com/astral-sh/ruff/pull/18948))
- Allow declared-only class-level attributes to be accessed on the class ([#19071](https://github.com/astral-sh/ruff/pull/19071))
- Infer nonlocal types as unions of all reachable bindings ([#18750](https://github.com/astral-sh/ruff/pull/18750))
- Use all reachable bindings for instance attributes and deferred lookups ([#18955](https://github.com/astral-sh/ruff/pull/18955))
- Improve protocol member type checking and relation handling ([#18847](https://github.com/astral-sh/ruff/pull/18847))
- Rework disjointness of protocol instances vs types with possibly unbound attributes, preventing some false instances of `Never` in `hasattr` narrowing ([#19043](https://github.com/astral-sh/ruff/pull/19043))
- Make tuple instantiations sound ([#18987](https://github.com/astral-sh/ruff/pull/18987))
- Add subdiagnostic about empty bodies in more cases ([#18942](https://github.com/astral-sh/ruff/pull/18942))
- Improve type-inference for `__import__(name)` and `importlib.import_module(name)` ([#19008](https://github.com/astral-sh/ruff/pull/19008))
- Eagerly evaluate certain constraints when analyzing control flow ([#18998](https://github.com/astral-sh/ruff/pull/18998), [#19044](https://github.com/astral-sh/ruff/pull/19044), [#19068](https://github.com/astral-sh/ruff/pull/19068))
- Update typeshed stubs ([#19060](https://github.com/astral-sh/ruff/pull/19060)): [typeshed diff](https://github.com/python/typeshed/compare/ecd5141cc036366cc9e3ca371096d6a14b0ccd13...3f727b0cd6620b7fca45318dd34542b1e1c7dbfb)

### Server

- Add `builtins` to completions ([#18982](https://github.com/astral-sh/ruff/pull/18982))
- Support LSP go-to with vendored typeshed stubs ([#19057](https://github.com/astral-sh/ruff/pull/19057))

### Documentation

- The ty documentation is now available at [docs.astral.sh/ty](https://docs.astral.sh/ty) ([#744](https://github.com/astral-sh/ty/pull/744))

### Performance

- Remove `ScopedExpressionId` ([#19019](https://github.com/astral-sh/ruff/pull/19019))

### Contributors

- [@InSyncWithFoo](https://github.com/InSyncWithFoo)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@dcreager](https://github.com/dcreager)
- [@mtshiba](https://github.com/mtshiba)
- [@BurntSushi](https://github.com/BurntSushi)
- [@sharkdp](https://github.com/sharkdp)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@github-actions](https://github.com/github-actions)
- [@carljm](https://github.com/carljm)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@MichaReiser](https://github.com/MichaReiser)
- [@zanieb](https://github.com/zanieb)

## 0.0.1-alpha.12

### Bug fixes

- Avoid duplicate diagnostic when reporting errors in unpacked assignments ([#18897](https://github.com/astral-sh/ruff/pull/18897))
- Fix panics when "pulling types" for `ClassVar` or `Final` parameterized with >1 argument ([#18824](https://github.com/astral-sh/ruff/pull/18824)). These could cause issues when hovering over symbols in an IDE.

### Improved modeling of Python runtime semantics

- Add support for `@staticmethod`s ([#18809](https://github.com/astral-sh/ruff/pull/18809))
- Discover implicit class attribute assignments in `@classmethod`-decorated methods. Recognize that assignments in the body of a `@staticmethod`-decorated method are never instance attributes ([#18587](https://github.com/astral-sh/ruff/pull/18587))
- Report when a dataclass contains more than one `KW_ONLY` field ([#18731](https://github.com/astral-sh/ruff/pull/18731))

### Type narrowing improvements

- Ty will now perform `isinstance()` and `issubclass()` narrowing when the second argument is a union type, intersection type or `TypeVar` type ([#18900](https://github.com/astral-sh/ruff/pull/18900))
- Ty now narrows types in comprehensions and generator expressions ([#18934](https://github.com/astral-sh/ruff/pull/18934))
- Understand two `NominalInstanceType`s as disjoint types if attempting to use multiple inheritance with their underlying classes would result in an instance memory layout conflict ([#18864](https://github.com/astral-sh/ruff/pull/18864))

### Other typing semantics features

- Support "mixed" tuples such as `tuple[int, *tuple[str, ...]]` ([#18600](https://github.com/astral-sh/ruff/pull/18600), [#18901](https://github.com/astral-sh/ruff/pull/18901))
- Support type inference for subscript expressions on union types ([#18846](https://github.com/astral-sh/ruff/pull/18846))
- Introduce a new subtyping framework in which gradual types can participate, allowing for more advanced union type simplification ([#18799](https://github.com/astral-sh/ruff/pull/18799))
- Surface the matched overload directly when reporting a diagnostic for an invalid call to an overloaded function ([#18452](https://github.com/astral-sh/ruff/pull/18452))

### Improvements to server autocompletions

- Add completions for `from module import <CURSOR>` ([#18830](https://github.com/astral-sh/ruff/pull/18830))
- Enforce sort order of completions ([#18917](https://github.com/astral-sh/ruff/pull/18917))
- Include imported sub-modules as attributes on modules for completions ([#18898](https://github.com/astral-sh/ruff/pull/18898))

### Configuration

- Anchor all `src.exclude` patterns, for consistency with `src.include` patterns ([#18685](https://github.com/astral-sh/ruff/pull/18685))
- Change `environment.root` to accept multiple paths ([#18913](https://github.com/astral-sh/ruff/pull/18913))
- Rename `src.root` setting to `environment.root` ([#18760](https://github.com/astral-sh/ruff/pull/18760))
- Support `--python=<symlink to executable>` ([#18827](https://github.com/astral-sh/ruff/pull/18827))

### Contributors

- [@BurntSushi](https://github.com/BurntSushi)
- [@InSyncWithFoo](https://github.com/InSyncWithFoo)
- [@suneettipirneni](https://github.com/suneettipirneni)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@sharkdp](https://github.com/sharkdp)
- [@MichaReiser](https://github.com/MichaReiser)
- [@med1844](https://github.com/med1844)
- [@dcreager](https://github.com/dcreager)
- [@carljm](https://github.com/carljm)

## 0.0.1-alpha.11

### Breaking changes

- Stabilize auto-complete; remove the opt-in experimental setting ([#18650](https://github.com/astral-sh/ruff/pull/18650))

### Bug fixes

- Fix binary expression inference between Boolean literals and `bool` instances ([#18663](https://github.com/astral-sh/ruff/pull/18663))
- Fix panic that could occur when printing a class's "header" in diagnostic messages ([#18670](https://github.com/astral-sh/ruff/pull/18670))
- Fix panic when attempting to provide autocompletions for an instance of a class that assigns attributes to `self[0]` ([#18707](https://github.com/astral-sh/ruff/pull/18707))
- Fix panics when "pulling types" for various special forms that have the wrong number of parameters. These could cause issues when hovering over symbols in an IDE. ([#18642](https://github.com/astral-sh/ruff/pull/18642))

### Typing semantics and features

- Support type narrowing for attribute and subscript expressions ([#17643](https://github.com/astral-sh/ruff/pull/17643))
- Add partial support for `TypeIs` ([#18589](https://github.com/astral-sh/ruff/pull/18589))
- Support `dataclasses.KW_ONLY` ([#18677](https://github.com/astral-sh/ruff/pull/18677))
- Filter overloads based on `Any` / `Unknown` ([#18607](https://github.com/astral-sh/ruff/pull/18607))
- Improve reachability analysis ([#18621](https://github.com/astral-sh/ruff/pull/18621))
- Model `T: Never` as a subtype of `Never` ([#18687](https://github.com/astral-sh/ruff/pull/18687))
- Update typeshed stubs ([#18679](https://github.com/astral-sh/ruff/pull/18679)): [typeshed diff](https://github.com/python/typeshed/compare/5a3c495d2f6fa9b68cd99f39feba4426e4d17ea9...ecd5141cc036366cc9e3ca371096d6a14b0ccd13)

### Configuration

- Allow overriding rules for specific files ([#18648](https://github.com/astral-sh/ruff/pull/18648))

### Server

- Add `python.ty.disableLanguageServices` config ([#18230](https://github.com/astral-sh/ruff/pull/18230))

### Contributors

- [@dhruvmanila](https://github.com/dhruvmanila)
- [@felixscherz](https://github.com/felixscherz)
- [@MichaReiser](https://github.com/MichaReiser)
- [@alpaylan](https://github.com/alpaylan)
- [@mtshiba](https://github.com/mtshiba)
- [@github-actions](https://github.com/github-actions)
- [@BurntSushi](https://github.com/BurntSushi)
- [@InSyncWithFoo](https://github.com/InSyncWithFoo)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@abhijeetbodas2001](https://github.com/abhijeetbodas2001)
- [@sharkdp](https://github.com/sharkdp)
- [@ibraheemdev](https://github.com/ibraheemdev)

## 0.0.1-alpha.10

### Server

- Improve support for `object.<CURSOR>` completions ([#18629](https://github.com/astral-sh/ruff/pull/18629))

### Configuration

- Add file inclusion and exclusion ([#18498](https://github.com/astral-sh/ruff/pull/18498))
- Infer the Python version from `--python=<system installation>` on Unix ([#18550](https://github.com/astral-sh/ruff/pull/18550))

### Bug fixes

- Delay computation of 'unbound' visibility for implicit instance attributes ([#18669](https://github.com/astral-sh/ruff/pull/18669)).
    This fixes a significant performance regression in version 0.0.1-alpha.9.

### Typing semantics and features

- Support the `del` statement; model implicit deletion of except handler names ([#18593](https://github.com/astral-sh/ruff/pull/18593))

### Release

- Include ruff/ directory in release source tarballs ([#617](https://github.com/astral-sh/ty/pull/617))

### Contributors

- [@AlexWaygood](https://github.com/AlexWaygood)
- [@BurntSushi](https://github.com/BurntSushi)
- [@Gankra](https://github.com/Gankra)
- [@mtshiba](https://github.com/mtshiba)
- [@sharkdp](https://github.com/sharkdp)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.1-alpha.9

### Typing semantics and features

- Add generic inference for dataclasses ([#18443](https://github.com/astral-sh/ruff/pull/18443))
- Add support for global `__debug__` constant ([#18540](https://github.com/astral-sh/ruff/pull/18540))
- Argument type expansion for overload call evaluation ([#18382](https://github.com/astral-sh/ruff/pull/18382))
- Exclude members starting with `_abc_` from a protocol interface ([#18467](https://github.com/astral-sh/ruff/pull/18467))
- Infer `list[T]` for starred target in unpacking ([#18401](https://github.com/astral-sh/ruff/pull/18401))
- Infer `list[T]` when unpacking non-tuple type ([#18438](https://github.com/astral-sh/ruff/pull/18438))
- Support type annotation for legacy typing aliases for generic classes ([#18404](https://github.com/astral-sh/ruff/pull/18404))
- Allow using `dataclasses.dataclass` as a function ([#18440](https://github.com/astral-sh/ruff/pull/18440))
- Type narrowing for attribute/subscript assignments ([#18041](https://github.com/astral-sh/ruff/pull/18041))

### Diagnostics

- Add hints to `invalid-type-form` for common mistakes ([#18543](https://github.com/astral-sh/ruff/pull/18543))
- Add subdiagnostic suggestion to `unresolved-reference` diagnostic when variable exists on `self` ([#18444](https://github.com/astral-sh/ruff/pull/18444))
- Track the origin of the `environment.python` setting for better error messages ([#18483](https://github.com/astral-sh/ruff/pull/18483))

### CLI

- Fix `--python` argument for Windows, and improve error messages for bad `--python` arguments ([#18457](https://github.com/astral-sh/ruff/pull/18457))

### Bug fixes

- Meta-type of type variables should be `type[..]` ([#18439](https://github.com/astral-sh/ruff/pull/18439))
- Only consider a type `T` a subtype of a protocol `P` if all of `P`'s members are fully bound on `T` ([#18466](https://github.com/astral-sh/ruff/pull/18466))
- Fix false positives for legacy `ParamSpec`s inside `Callable` type expressions ([#18426](https://github.com/astral-sh/ruff/pull/18426))
- Fix panic when pulling types for `UnaryOp` expressions inside `Literal` slices ([#18536](https://github.com/astral-sh/ruff/pull/18536))
- Fix panic when trying to pull types for attribute expressions inside `Literal` type expressions ([#18535](https://github.com/astral-sh/ruff/pull/18535))
- Fix panic when trying to pull types for subscript expressions inside `Callable` type expressions ([#18534](https://github.com/astral-sh/ruff/pull/18534))
- Treat lambda functions as instances of `types.FunctionType` ([#18431](https://github.com/astral-sh/ruff/pull/18431))
- Implement disjointness between `Callable` and `SpecialForm` ([#18503](https://github.com/astral-sh/ruff/pull/18503))

### Server

- Fix stale diagnostics in documents on Windows ([#18544](https://github.com/astral-sh/ruff/pull/18544))
- Add support for `object.<CURSOR>` completions ([#18468](https://github.com/astral-sh/ruff/pull/18468))
- Only provide declarations and bindings as completions ([#18456](https://github.com/astral-sh/ruff/pull/18456))

### Documentation

- Add `CONDA_PREFIX` to `--python` documentation ([#18574](https://github.com/astral-sh/ruff/pull/18574))
- Update list of referenced environment variables ([#612](https://github.com/astral-sh/ty/pull/612))
- Document how the default value for `python-version` is determined ([#18549](https://github.com/astral-sh/ruff/pull/18549))
- Document the `"all"` option for `python-platform` ([#18548](https://github.com/astral-sh/ruff/pull/18548))

### Contributors

- [@AlexWaygood](https://github.com/AlexWaygood)
- [@charliermarsh](https://github.com/charliermarsh)
- [@mtshiba](https://github.com/mtshiba)
- [@benbaror](https://github.com/benbaror)
- [@sharkdp](https://github.com/sharkdp)
- [@carljm](https://github.com/carljm)
- [@MichaReiser](https://github.com/MichaReiser)
- [@lipefree](https://github.com/lipefree)
- [@BurntSushi](https://github.com/BurntSushi)
- [@DetachHead](https://github.com/DetachHead)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@suneettipirneni](https://github.com/suneettipirneni)
- [@abhijeetbodas2001](https://github.com/abhijeetbodas2001)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@dhruvmanila](https://github.com/dhruvmanila)

## 0.0.1-alpha.8

### Typing semantics and features

- Add subtyping between Callable types and class literals with `__init__` ([#17638](https://github.com/astral-sh/ruff/pull/17638))
- Implement implicit inheritance from `Generic[]` for PEP-695 generic classes ([#18283](https://github.com/astral-sh/ruff/pull/18283))
- Infer the Python version from the environment if feasible ([#18057](https://github.com/astral-sh/ruff/pull/18057))
- Support ephemeral uv virtual environments ([#18335](https://github.com/astral-sh/ruff/pull/18335))
- Model that some `Callable` types should have all `FunctionType` attributes available ([#18242](https://github.com/astral-sh/ruff/pull/18242))

### Diagnostics

- Add diagnostic hints for a function that has a non-`None` return-type annotation but no return statements ([#18359](https://github.com/astral-sh/ruff/pull/18359))
- Add hint if async context manager is used in non-async with statement ([#18299](https://github.com/astral-sh/ruff/pull/18299))
- Improve diagnostics if the user attempts to import a stdlib module that does not exist on their configured Python version ([#18403](https://github.com/astral-sh/ruff/pull/18403))
- Tell the user why we inferred a certain Python version when reporting version-specific syntax errors ([#18295](https://github.com/astral-sh/ruff/pull/18295))

### Bug fixes

- Fix multithreading related hangs and panics ([#18238](https://github.com/astral-sh/ruff/pull/18238))
- Ensure `Literal` types are considered assignable to anything their `Instance` supertypes are assignable to ([#18351](https://github.com/astral-sh/ruff/pull/18351))
- Callable types are disjoint from non-callable `@final` nominal instance types ([#18368](https://github.com/astral-sh/ruff/pull/18368))
- Support callability of bound/constrained typevars ([#18389](https://github.com/astral-sh/ruff/pull/18389))

### Server

- Fix server hang after shutdown request ([#18414](https://github.com/astral-sh/ruff/pull/18414))
- Improve completions by leveraging scopes ([#18281](https://github.com/astral-sh/ruff/pull/18281))
- Support cancellation and retry in the server ([#18273](https://github.com/astral-sh/ruff/pull/18273))
- Support publishing diagnostics in the server ([#18309](https://github.com/astral-sh/ruff/pull/18309))

### CLI

- Add `--config-file` CLI arg ([#18083](https://github.com/astral-sh/ruff/pull/18083))

### Contributors

- [@AlexWaygood](https://github.com/AlexWaygood)
- [@BurntSushi](https://github.com/BurntSushi)
- [@lipefree](https://github.com/lipefree)
- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@zanieb](https://github.com/zanieb)
- [@carljm](https://github.com/carljm)
- [@thejchap](https://github.com/thejchap)
- [@sharkdp](https://github.com/sharkdp)
- [@InSyncWithFoo](https://github.com/InSyncWithFoo)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.1-alpha.7

### Bug fixes

- Implement Python's floor-division semantics for `Literal` `int`s ([#18249](https://github.com/astral-sh/ruff/pull/18249))
- Don't warn about a `yield` expression not being in a function if the `yield` expression is in a function ([#18008](https://github.com/astral-sh/ruff/pull/18008))
- Fix inference of attribute writes to unions/intersections that including module-literal types ([#18313](https://github.com/astral-sh/ruff/pull/18313))
- Fix false-positive diagnostics in binary comparison inference logic for intersection types ([#18266](https://github.com/astral-sh/ruff/pull/18266))
- Fix instance vs callable subtyping/assignability ([#18260](https://github.com/astral-sh/ruff/pull/18260))
- Ignore `ClassVar` declarations when resolving instance members ([#18241](https://github.com/astral-sh/ruff/pull/18241))
- Fix crash when hovering over a `ty_extensions.Intersection[A, B]` expression in an IDE context ([#18321](https://github.com/astral-sh/ruff/pull/18321))
- Respect `MRO_NO_OBJECT_FALLBACK` policy when looking up symbols on `type` instances ([#18312](https://github.com/astral-sh/ruff/pull/18312))
- `get_protocol_members` returns a frozenset, not a tuple ([#18284](https://github.com/astral-sh/ruff/pull/18284))

### Typing semantics and features

- Support `import <namespace>` and `from <namespace> import module` ([#18137](https://github.com/astral-sh/ruff/pull/18137))
- Support frozen dataclasses ([#17974](https://github.com/astral-sh/ruff/pull/17974))
- Understand that the presence of a `__getattribute__` method indicates arbitrary members can exist on a type ([#18280](https://github.com/astral-sh/ruff/pull/18280))
- Add a subdiagnostic if `invalid-return-type` is emitted on a method with an empty body on a non-protocol subclass of a protocol class ([#18243](https://github.com/astral-sh/ruff/pull/18243))
- Improve `invalid-type-form` diagnostic where a module-literal type is used in a type expression and the module has a member which would be valid in a type expression ([#18244](https://github.com/astral-sh/ruff/pull/18244))
- Split `invalid-base` error code into two error codes ([#18245](https://github.com/astral-sh/ruff/pull/18245))
- Rename `call-possibly-unbound-method` to `possibly-unbound-implicit-call` ([#18017](https://github.com/astral-sh/ruff/pull/18017))

### Configuration

- Add `tests` to `src.root` by default if a `tests/` directory exists and is not a package ([#18286](https://github.com/astral-sh/ruff/pull/18286))
- Tell the user why we inferred the Python version we inferred ([#18082](https://github.com/astral-sh/ruff/pull/18082))
- Add support for detecting activated Conda and Pixi environments ([#18267](https://github.com/astral-sh/ruff/pull/18267))
- Move `respect-ignore-files` configuration setting under `src` section ([#18322](https://github.com/astral-sh/ruff/pull/18322))

### Server

- Fix server panic when calling `system_mut` ([#18252](https://github.com/astral-sh/ruff/pull/18252))
- Abort process if worker thread panics ([#18211](https://github.com/astral-sh/ruff/pull/18211))
- Gracefully handle salsa cancellations and panics in background request handlers ([#18254](https://github.com/astral-sh/ruff/pull/18254))

### Contributors

- [@felixscherz](https://github.com/felixscherz)
- [@carljm](https://github.com/carljm)
- [@j178](https://github.com/j178)
- [@thejchap](https://github.com/thejchap)
- [@brainwane](https://github.com/brainwane)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@lipefree](https://github.com/lipefree)
- [@InSyncWithFoo](https://github.com/InSyncWithFoo)
- [@brandtbucher](https://github.com/brandtbucher)
- [@MichaReiser](https://github.com/MichaReiser)
- [@maxmynter](https://github.com/maxmynter)
- [@fabridamicelli](https://github.com/fabridamicelli)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.1-alpha.6

### Server

- Add rule link to server diagnostics ([#18128](https://github.com/astral-sh/ruff/pull/18128))
- Avoid panicking when there are multiple workspaces ([#18151](https://github.com/astral-sh/ruff/pull/18151))
- Show related information in diagnostic ([#17359](https://github.com/astral-sh/ruff/pull/17359))

### Configuration

- Default `src.root` setting to `['.', '<project_name>']` if an `src/` directory does not exist but a `<project-name>/<project-name>` directory does exist ([#18141](https://github.com/astral-sh/ruff/pull/18141))

### Typing semantics and features

- Consider a class with a dynamic element in its MRO assignable to any subtype of `type` ([#18205](https://github.com/astral-sh/ruff/pull/18205))
- Ensure that a function-literal type is always considered equivalent to itself ([#18227](https://github.com/astral-sh/ruff/pull/18227))
- Promote literals when inferring class specializations from constructors ([#18102](https://github.com/astral-sh/ruff/pull/18102))
- Support `typing.TypeAliasType` ([#18156](https://github.com/astral-sh/ruff/pull/18156))
- Infer function-call type variables in both directions ([#18155](https://github.com/astral-sh/ruff/pull/18155))

### Improvements to modeling of runtime semantics

- Integer indexing into `bytes` returns `int` ([#18218](https://github.com/astral-sh/ruff/pull/18218))
- Emit `invalid-exception-caught` diagnostics even when the caught exception is not bound to a variable ([#18202](https://github.com/astral-sh/ruff/pull/18202))

### Usability improvements

- Add hint to some diagnostics that [PEP 604](https://peps.python.org/pep-0604/) union syntax is only available on Python 3.10+ ([#18192](https://github.com/astral-sh/ruff/pull/18192))
- Add note to `unresolved-import` diagnostic hinting to users to configure their Python environment ([#18207](https://github.com/astral-sh/ruff/pull/18207))
- Make `division-by-zero` an opt-in diagnostic rather than opt-out ([#18220](https://github.com/astral-sh/ruff/pull/18220))

### Import resolution improvements

- Add support for PyPy virtual environments ([#18203](https://github.com/astral-sh/ruff/pull/18203))

### Contributors

- [@dhruvmanila](https://github.com/dhruvmanila)
- [@InSyncWithFoo](https://github.com/InSyncWithFoo)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@MichaReiser](https://github.com/MichaReiser)
- [@BradonZhang](https://github.com/BradonZhang)
- [@dcreager](https://github.com/dcreager)
- [@danielhollas](https://github.com/danielhollas)
- [@esadek](https://github.com/esadek)
- [@kiran-4444](https://github.com/kiran-4444)
- [@Mathemmagician](https://github.com/Mathemmagician)
- [@sharkdp](https://github.com/sharkdp)
- [@felixscherz](https://github.com/felixscherz)
- [@adamaaronson](https://github.com/adamaaronson)
- [@carljm](https://github.com/carljm)

## 0.0.1-alpha.5

### Bug fixes

- Fix assignability checks for invariant generics parameterized by gradual types ([#18138](https://github.com/astral-sh/ruff/pull/18138))
- Revert boolean expression control flow change which caused a performance regression ([#18150](https://github.com/astral-sh/ruff/pull/18150))
- Remove pyvenv.cfg validation check for lines with multiple `=` ([#18144](https://github.com/astral-sh/ruff/pull/18144))

### Contributors

- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@AlexWaygood](https://github.com/AlexWaygood)

## 0.0.1-alpha.4

### Enhancements

- Allow unions including `Any`/`Unknown` as bases ([#18094](https://github.com/astral-sh/ruff/pull/18094))
- Better control flow for boolean expressions that are inside if ([#18010](https://github.com/astral-sh/ruff/pull/18010))
- Improve invalid method calls for unmatched overloads ([#18122](https://github.com/astral-sh/ruff/pull/18122))
- Add support for `NamedTuple` 'fallback' attributes ([#18127](https://github.com/astral-sh/ruff/pull/18127))
- `type[…]` is always assignable to `type` ([#18121](https://github.com/astral-sh/ruff/pull/18121))
- Support accessing `__builtins__` global ([#18118](https://github.com/astral-sh/ruff/pull/18118))

### Bug fixes

- Fix relative imports in stub packages ([#18132](https://github.com/astral-sh/ruff/pull/18132))

### Contributors

- [@MatthewMckee4](https://github.com/MatthewMckee4)
- [@felixscherz](https://github.com/felixscherz)
- [@BurntSushi](https://github.com/BurntSushi)
- [@maxmynter](https://github.com/maxmynter)
- [@sharkdp](https://github.com/sharkdp)
- [@TomerBin](https://github.com/TomerBin)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.1-alpha.3

### Enhancements

- Include synthesized arguments in displayed counts for `too-many-positional-arguments` ([#18098](https://github.com/astral-sh/ruff/pull/18098))

### Bug fixes

- Fix `redundant-cast` false positives when casting to `Unknown` ([#18111](https://github.com/astral-sh/ruff/pull/18111))
- Fix normalization of unions containing instances parameterized with unions ([#18112](https://github.com/astral-sh/ruff/pull/18112))
- Make dataclass instances adhere to DataclassInstance ([#18115](https://github.com/astral-sh/ruff/pull/18115))

### CLI

- Change layout of extra verbose output and respect `--color` for verbose output ([#18089](https://github.com/astral-sh/ruff/pull/18089))

### Documentation

- Use Cargo-style versions in the changelog ([#397](https://github.com/astral-sh/ty/pull/397))

### Contributors

- [@zanieb](https://github.com/zanieb)
- [@sharkdp](https://github.com/sharkdp)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@InSyncWithFoo](https://github.com/InSyncWithFoo)
- [@MichaReiser](https://github.com/MichaReiser)

## 0.0.1-alpha.2

### Enhancements

- Improve diagnostics for failure to call overloaded function ([#18073](https://github.com/astral-sh/ruff/pull/18073))
- Fix inconsistent casing in `invalid-return-type` diagnostic ([#18084](https://github.com/astral-sh/ruff/pull/18084))
- Add type-expression syntax link to `invalid-type-expression` diagnostics ([#18104](https://github.com/astral-sh/ruff/pull/18104))

### Bug fixes

- Add cycle handling for unpacking targets ([#18078](https://github.com/astral-sh/ruff/pull/18078))
- Do not look up `__init__` on instances ([#18092](https://github.com/astral-sh/ruff/pull/18092))

### Typing

- Infer parameter specializations of explicitly implemented generic protocols ([#18054](https://github.com/astral-sh/ruff/pull/18054))
- Check assignments to implicit global symbols are assignable to the types declared on `types.ModuleType` ([#18077](https://github.com/astral-sh/ruff/pull/18077))
- Fix various generics-related TODOs ([#18062](https://github.com/astral-sh/ruff/pull/18062))

### Documentation

- Fix rule link in the configuration description ([#381](https://github.com/astral-sh/ty/pull/381))
- Use `https://ty.dev/rules` when linking to the rules table ([#18072](https://github.com/astral-sh/ruff/pull/18072))
- Use `ty server` instead of `ty lsp` ([#360](https://github.com/astral-sh/ty/pull/360))
- Fix missing `>` in HTML anchor tags in CLI reference ([#18096](https://github.com/astral-sh/ruff/pull/18096))
- Fix link to rules docs ([#378](https://github.com/astral-sh/ty/pull/378))
- Fix repository in README transform script ([#361](https://github.com/astral-sh/ty/pull/361))

### Contributors

- [@dhruvmanila](https://github.com/dhruvmanila)
- [@Usul-Dev](https://github.com/Usul-Dev)
- [@dcreager](https://github.com/dcreager)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@BurntSushi](https://github.com/BurntSushi)
- [@MichaReiser](https://github.com/MichaReiser)
- [@frgfm](https://github.com/frgfm)
- [@kiran-4444](https://github.com/kiran-4444)
- [@sharkdp](https://github.com/sharkdp)
- [@eruditmorina](https://github.com/eruditmorina)

## 0.0.1-alpha.1

### Enhancements

- Add basic support for non-virtual Python environments ([#17991](https://github.com/astral-sh/ruff/pull/17991))
- Do not allow invalid virtual environments from discovered `.venv` or `VIRTUAL_ENV` ([#18003](https://github.com/astral-sh/ruff/pull/18003))
- Refine message for why a rule is enabled ([#18038](https://github.com/astral-sh/ruff/pull/18038))
- Update `--python` to accept paths to executables in environments ([#17954](https://github.com/astral-sh/ruff/pull/17954))
- Improve diagnostics for `assert_type` and `assert_never` ([#18050](https://github.com/astral-sh/ruff/pull/18050))
- Add a note to the diagnostic if a new builtin is used on an old Python version ([#18068](https://github.com/astral-sh/ruff/pull/18068))

### Bug fixes

- Fix infinite recursion bug in `is_disjoint_from` ([#18043](https://github.com/astral-sh/ruff/pull/18043))
- Recognize submodules in self-referential imports ([#18005](https://github.com/astral-sh/ruff/pull/18005))

### Typing

- Allow a class to inherit from an intersection if the intersection contains a dynamic type and the intersection is not disjoint from `type` ([#18055](https://github.com/astral-sh/ruff/pull/18055))
- Allow classes to inherit from `type[Any]` or `type[Unknown]` ([#18060](https://github.com/astral-sh/ruff/pull/18060))
- Apply function specialization to all overloads ([#18020](https://github.com/astral-sh/ruff/pull/18020))
- Implement `DataClassInstance` protocol for dataclasses ([#18018](https://github.com/astral-sh/ruff/pull/18018))
- Induct into instances and subclasses when finding and applying generics ([#18052](https://github.com/astral-sh/ruff/pull/18052))
- Infer parameter specializations of generic aliases ([#18021](https://github.com/astral-sh/ruff/pull/18021))
- Narrowing for `hasattr()` ([#18053](https://github.com/astral-sh/ruff/pull/18053))
- Silence false positives for PEP-695 ParamSpec annotations ([#18001](https://github.com/astral-sh/ruff/pull/18001))
- Understand homogeneous tuple annotations ([#17998](https://github.com/astral-sh/ruff/pull/17998))
- `__file__` is always a string inside a Python module ([#18071](https://github.com/astral-sh/ruff/pull/18071))

### CLI

- Avoid initializing progress bars early ([#18049](https://github.com/astral-sh/ruff/pull/18049))

### Contributors

- [@soof-golan](https://github.com/soof-golan)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@dhruvmanila](https://github.com/dhruvmanila)
- [@charliermarsh](https://github.com/charliermarsh)
- [@MichaReiser](https://github.com/MichaReiser)
- [@carljm](https://github.com/carljm)
- [@abhijeetbodas2001](https://github.com/abhijeetbodas2001)
- [@zanieb](https://github.com/zanieb)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@dcreager](https://github.com/dcreager)
- [@mtshiba](https://github.com/mtshiba)
- [@sharkdp](https://github.com/sharkdp)

## 0.0.0-alpha.8

### Changes

- Add `--config` CLI arg ([#17697](https://github.com/astral-sh/ruff/pull/17697))
- Add CLI documentation and update README ([#284](https://github.com/astral-sh/ty/pull/284))
- Add a warning about pre-release status to the CLI ([#17983](https://github.com/astral-sh/ruff/pull/17983))
- Add missing bitwise-operator branches for boolean and integer arithmetic ([#17949](https://github.com/astral-sh/ruff/pull/17949))
- Add progress bar for `ty check` ([#17965](https://github.com/astral-sh/ruff/pull/17965))
- Add CLI reference ([#17978](https://github.com/astral-sh/ruff/pull/17978))
- Change default severity for `unbound-reference` to `error` ([#17936](https://github.com/astral-sh/ruff/pull/17936))
- Change range of `revealed-type` diagnostic to be the range of the argument passed in, not the whole call ([#17980](https://github.com/astral-sh/ruff/pull/17980))
- Default to latest supported Python version ([#17938](https://github.com/astral-sh/ruff/pull/17938))
- Display "All checks passed!" message in green ([#17982](https://github.com/astral-sh/ruff/pull/17982))
- Document configuration schema ([#17950](https://github.com/astral-sh/ruff/pull/17950))
- Generate and add rules table ([#17953](https://github.com/astral-sh/ruff/pull/17953))
- Handle type variables that have other type variables as a default ([#17956](https://github.com/astral-sh/ruff/pull/17956))
- Ignore `possibly-unresolved-reference` by default ([#17934](https://github.com/astral-sh/ruff/pull/17934))
- Implement `global` handling and `load-before-global-declaration` syntax error ([#17637](https://github.com/astral-sh/ruff/pull/17637))
- Make `unused-ignore-comment` disabled by default for now ([#17955](https://github.com/astral-sh/ruff/pull/17955))
- Recognise functions containing `yield from` expressions as being generator functions ([#17930](https://github.com/astral-sh/ruff/pull/17930))
- Fix stack overflow on recursive protocols ([#17929](https://github.com/astral-sh/ruff/pull/17929))
- Report duplicate `Protocol` or `Generic` base classes with `[duplicate-base]`, not `[inconsistent-mro]` ([#17971](https://github.com/astral-sh/ruff/pull/17971))
- Respect the gradual guarantee when reporting errors in resolving MROs ([#17962](https://github.com/astral-sh/ruff/pull/17962))
- Support `typing.Self` in methods ([#17689](https://github.com/astral-sh/ruff/pull/17689))
- Support extending `__all__` from an imported module even when the module is not an `ExprName` node ([#17947](https://github.com/astral-sh/ruff/pull/17947))
- Support extending `__all__` with a literal tuple or set as well as a literal list ([#17948](https://github.com/astral-sh/ruff/pull/17948))
- Understand classes that inherit from subscripted `Protocol[]` as generic ([#17832](https://github.com/astral-sh/ruff/pull/17832))
- Update ty metadata ([#17943](https://github.com/astral-sh/ruff/pull/17943))
- Add `py.typed` ([#276](https://github.com/astral-sh/ty/pull/276))
- Bottom-up improvement of diagnostic messages for union type function calls ([#17984](https://github.com/astral-sh/ruff/pull/17984))
- Fix more ecosystem/fuzzer panics with fixpoint ([#17758](https://github.com/astral-sh/ruff/pull/17758))
- Remove `lint:` prefix from top-level diagnostic preamble ([#17987](https://github.com/astral-sh/ruff/pull/17987))

### Contributors

- [@Glyphack](https://github.com/Glyphack)
- [@BurntSushi](https://github.com/BurntSushi)
- [@paul-nameless](https://github.com/paul-nameless)
- [@MichaReiser](https://github.com/MichaReiser)
- [@ntbre](https://github.com/ntBre)
- [@ibraheemdev](https://github.com/ibraheemdev)
- [@sharkdp](https://github.com/sharkdp)
- [@thejchap](https://github.com/thejchap)
- [@carljm](https://github.com/carljm)
- [@jorenham](https://github.com/jorenham)
- [@AlexWaygood](https://github.com/AlexWaygood)
- [@dcreager](https://github.com/dcreager)