Update build tools to use hatchling and fix reflex build (deployment) (#20)

* fix: Manual version bumping with working .pyi generation

- Add build-component task that generates .pyi files selectively
- Run pyi_generator from custom_components/ to avoid scanning tests/demo
- Fix typecheck by excluding auto-generated .pyi files and build dirs
- Fix type error in ClerkProvider.create() using typing.Self
- Update bump tasks to echo manual version update instructions

* chore: Bump version to 1.2.1

* feat: Switch to hatchling with automatic version bumping

- Use hatchling build backend for automatic version management
- Configure hatchling to include .pyi artifacts in wheel
- Restore task bump-patch/minor/major with hatch version commands
- Bump version to 1.2.2 for testing

Build verified: 7 .pyi files included, typecheck passes

Author: TimChild

Taskfile.yml

@@ -36,16 +36,19 @@ tasks:
       - uv run pyright
 
   bump-patch:
+    desc: Bump patch version (e.g., 1.1.3 -> 1.1.4)
     cmds:
       - uvx hatch version patch
       - uv lock
 
   bump-minor:
+    desc: Bump minor version (e.g., 1.1.3 -> 1.2.0)
     cmds:
       - uvx hatch version minor
       - uv lock
 
   bump-major:
+    desc: Bump major version (e.g., 1.1.3 -> 2.0.0)
     cmds:
       - uvx hatch version major
       - uv lock
@@ -68,15 +71,24 @@ tasks:
     cmds:
       - uv run pre-commit autoupdate
 
+  build-component:
+    desc: Build the reflex component (generates .pyi stubs and package dist)
+    cmds:
+      # Generate .pyi files from custom_components to avoid scanning tests/demo dirs
+      # This is the same as what `reflex component build` does, but selective to avoid
+      # scanning tests/demo directories which causes ModuleNotFoundError (issue #5114)
+      - cd custom_components && uv run python -m reflex.utils.pyi_generator reflex_clerk_api
+      # Build package from root (same as `python -m build .` in reflex component build)
+      - uv run python -m build .
+
   manual-publish:
     preconditions:
       # Check environment variable
       - sh: test -n "$PYPI_TOKEN"
         msg: "PYPI_TOKEN is not set -- Add PYPI_TOKEN=... to .env file"
     cmds:
       - echo "Publishing to PyPI"
-      # - uv run reflex component build  # Until https://github.com/reflex-dev/reflex/issues/5114 is resolved
-      - uvx reflex==0.7.5 component build
+      - task: build-component
       - uv publish --token $PYPI_TOKEN
 
   manual-publish-docs:

custom_components/reflex_clerk_api/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.2.0"
+__version__ = "1.2.2"
 
 from .authentication_components import sign_in, sign_up
 from .clerk_provider import (

custom_components/reflex_clerk_api/clerk_provider.py

@@ -4,7 +4,7 @@
 import time
 import uuid
 from collections.abc import Callable
-from typing import Any, ClassVar, TypeVar
+from typing import Any, ClassVar, Self, TypeVar, cast
 
 import authlib.jose.errors as jose_errors
 import clerk_backend_api
@@ -535,8 +535,8 @@ class ClerkProvider(ClerkBase):
     """The full URL or path to the waitlist page."""
 
     @classmethod
-    def create(cls, *children, **props) -> "ClerkProvider":
-        return super().create(*children, **props)
+    def create(cls, *children, **props) -> Self:
+        return cast(Self, super().create(*children, **props))
 
     def add_custom_code(self) -> list[str]:
         return []

pyproject.toml

@@ -1,15 +1,15 @@
 [build-system]
-requires = ["setuptools", "wheel", "hatchling"]
-build-backend = "setuptools.build_meta"
+requires = ["hatchling"]
+build-backend = "hatchling.build"
 
 [project.optional-dependencies]
 dev = ["build", "twine"]
 
-[tool.setuptools.packages.find]
-where = ["custom_components"]
+[tool.hatch.build.targets.wheel]
+packages = ["custom_components/reflex_clerk_api"]
 
-[tool.setuptools.dynamic]
-version = { attr = "reflex_clerk_api.__version__" }
+[tool.hatch.build]
+artifacts = ["*.pyi"]
 
 [tool.hatch.version]
 path = "custom_components/reflex_clerk_api/__init__.py"
@@ -51,6 +51,14 @@ homepage = "https://reflex-clerk-api-demo.adventuresoftim.com"
 [tool.pyright]
 venvPath = "."
 venv = ".venv"
+exclude = [
+    "**/*.pyi",  # Exclude auto-generated .pyi files (not committed, have generator bugs)
+    ".venv",     # Exclude virtual environment
+    "dist",      # Exclude build artifacts
+    "*.egg-info",
+    "**/.web",   # Exclude Reflex web build directory
+    "**/node_modules",  # Exclude npm dependencies
+]
 
 [tool.ruff.lint]
 extend-select = ["I", "RUF", "T20"]