ci(tests) Verify runtime deps, fix runtime dep issue (#965)

## Changes
- Add runtime dependency check in CI using `uv run --no-dev`
- Run check before installing dev dependencies
- Print package version and basic functionality test results
- Document improvement in CHANGES
- Fix runtime issue in _internal/types.py

## Verification

https://github.com/tmux-python/tmuxp/actions/runs/13411308953/job/37461974473#step:5:24

uv run --no-dev -p python3.13 -- python -c '
  from tmuxp import _internal, cli, workspace, exc, log, plugin, shell, types, util, __version__
  from tmuxp._internal import config_reader, types
  from tmuxp.workspace import builder, constants, finders, freezer, importers, loader, validation
  from libtmux import __version__ as __libtmux_version__
  print("tmuxp version:", __version__)
  print("libtmux version:", __libtmux_version__)
  '
  shell: /usr/bin/bash -e {0}
  env:
    UV_CACHE_DIR: /home/runner/work/_temp/setup-uv-cache
Using CPython 3.13.2
Creating virtual environment at: .venv
   Building tmuxp @ file:///home/runner/work/tmuxp/tmuxp
      Built tmuxp @ file:///home/runner/work/tmuxp/tmuxp
Installed 4 packages in 1ms
Traceback (most recent call last):
  File "<string>", line 3, in <module>
    from tmuxp._internal import config_reader, types
  File "/home/runner/work/tmuxp/tmuxp/src/tmuxp/_internal/types.py", line 15, in <module>
    from typing_extensions import NotRequired, TypedDict
ModuleNotFoundError: No module named 'typing_extensions'

## See also

- tmux-python/libtmux#574

## Summary by Sourcery

CI:
- Adds a CI job to verify that runtime dependencies are installed correctly and that the application can import its modules and dependencies.

Author: tony

.github/workflows/tests.yml

@@ -29,6 +29,17 @@ jobs:
       - name: Set up Python ${{ matrix.python-version }}
         run: uv python install ${{ matrix.python-version }}
 
+      - name: Test runtime dependencies
+        run: |
+          uv run --no-dev -p python${{ matrix.python-version }} -- python -c '
+          from tmuxp import _internal, cli, workspace, exc, log, plugin, shell, types, util, __version__
+          from tmuxp._internal import config_reader, types
+          from tmuxp.workspace import builder, constants, finders, freezer, importers, loader, validation
+          from libtmux import __version__ as __libtmux_version__
+          print("tmuxp version:", __version__)
+          print("libtmux version:", __libtmux_version__)
+          '
+
       - name: Install dependencies
         run: uv sync --all-extras --dev
 

CHANGES

@@ -21,8 +21,13 @@ $ pipx install --suffix=@next 'tmuxp' --pip-args '\--pre' --force
 
 - _Future release notes will be placed here_
 
+### Bug fixes
+
+- Fix import type unavailable at runtime (#965)
+
 ### Development
 
+- CI: Check for runtime dependencies (#965)
 - Tests: Improve parametrized test suite (#964)
 
   Convert remaining `pytest.mark.parametrize()` tests to `NamedTuple` fixtures:

src/tmuxp/_internal/types.py

@@ -12,7 +12,16 @@
 
 from __future__ import annotations
 
-from typing_extensions import NotRequired, TypedDict
+import typing as t
+from typing import TypedDict
+
+if t.TYPE_CHECKING:
+    import sys
+
+    if sys.version_info >= (3, 11):
+        from typing import NotRequired
+    else:
+        from typing_extensions import NotRequired
 
 
 class PluginConfigSchema(TypedDict):