Upgrade dev tooling and fix docstring style

[masenf]

Type of change

• Bug fix (non-breaking change which fixes an issue)

Changes To Core Features:

• Have you added an explanation of what your changes do and why you'd like us to include them?

Description

This PR upgrades locked dev tooling and addresses linting issues introduced by the new versions:

Tooling upgrades:

• ruff 0.15.12 → 0.16.2
• pyright 1.1.408 → 1.1.411
• typer 0.25.1 → 0.27.1

Key changes:

1. Property docstring style (ruff D421): Updated all property docstrings from imperative form ("Get the ...", "Return the ...") to noun phrases ("The ..."). This applies across:

   • reflex/app.py
   • reflex/compiler/compiler.py
   • reflex/experimental/client_state.py
   • reflex/istate/
   • packages/reflex-base/src/reflex_base/ (vars, event, config, registry, plugins)
   • packages/reflex-components-core/src/reflex_components_core/
   • packages/reflex-docgen/src/reflex_docgen/
   • packages/reflex-components-internal/src/reflex_components_internal/

2. Type safety improvements:

   • Added cast() calls in reflex/compiler/compiler.py and reflex/reflex.py for untyped libsass and typer APIs
   • Fixed type annotation in packages/reflex-base/src/reflex_base/vars/base.py for default_value with explanatory comment
   • Removed redundant EventSpec import from TYPE_CHECKING block in packages/reflex-base/src/reflex_base/event/processor/base_state_processor.py
   • Changed chain_updates() parameter type from EventSpec | list[EventSpec] | None to Any with updated docstring explaining runtime validation

3. Code quality fixes:

   • Simplified condition in packages/reflex-base/src/reflex_base/utils/types.py (removed redundant cls is not None check)
   • Fixed import organization in packages/reflex-base/src/reflex_base/vars/datetime.py (moved ImportVar to correct location)
   • Improved control flow in packages/reflex-base/src/reflex_base/vars/dep_tracking.py (split compound condition for clarity)

4. Test infrastructure:

   • Created tests/units/reflex_cli/v2/utils.py with as_click_command() helper to reduce duplication across CLI tests
   • Updated all CLI test files to use the new helper
   • Removed redundant scope="function" parameter from pytest_asyncio.fixture decorators (already set by loop_scope)

5. Linting configuration:

   • Added ASYNC119 to ignore list (background event handlers hold async with self across yield by design)
   • Added RUF075 to ignore list (state managers deliberately skip write-back when with body raises)
   • Added RUF105 and RUF201 to ignore list (preserve noqa comment readability)

Test Plan

Existing unit tests pass. The changes are primarily:

• Docstring style updates (no functional impact)
• Type annotations and casts for better type checking
• Test infrastructure refactoring (DRY principle)
• Linting configuration updates

All changes maintain backward compatibility and improve code quality without altering runtime behavior.

https://claude.ai/code/session_01RLumacyNrCZDqvyptaVxkE

[greptile-apps]

Greptile Summary

This PR upgrades the locked development tooling and updates the codebase for the resulting lint and type-checking requirements.

• Converts property docstrings to noun phrases for the new Ruff rule.
• Adds type annotations and casts around field defaults, logging streams, libsass, and Typer’s vendored Click implementation.
• Refactors CLI test command conversion into a shared helper and updates asynchronous fixture declarations.
• Refreshes the development dependency lockfile and lint configuration.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename	Overview
pyproject.toml	Updates development-tool constraints and Ruff ignores to accommodate the upgraded linting behavior.
uv.lock	Refreshes locked development dependencies, including Ruff, Pyright, and Typer.
reflex/reflex.py	Casts Typer’s generated command to Click’s command interface for registration with the root CLI.
reflex/compiler/compiler.py	Adds a type-only cast around the untyped libsass API without changing runtime behavior.
packages/reflex-base/src/reflex_base/vars/base.py	Widens field default annotations to represent the existing possibility of a None default.
packages/reflex-base/src/reflex_base/vars/dep_tracking.py	Restructures the IMPORT_NAME guard without changing bytecode-scanner behavior.
packages/reflex-base/src/reflex_base/event/processor/base_state_processor.py	Aligns the chain_updates input annotation and documentation with its existing runtime validation.
tests/units/reflex_cli/v2/utils.py	Introduces a shared helper for adapting Typer applications to Click commands in CLI tests.

_{Reviews (2): Last reviewed commit: "Upgrade ruff, pyright, and typer; fix th..." | Re-trigger Greptile}

[codspeed-hq]

Merging this PR will not alter performance

✅ 27 untouched benchmarks
⏩ 8 skipped benchmarks¹

---

_{Comparing claude/upgrade-ruff-pyright-typer-u3z09k (e1544df) with main (d02e452)}

Footnotes

1. 8 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

[cubic-dev-ai]

All reported issues were addressed across 59 files

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>