implement reflex docgen

[adhami3310]

No description provided.

[codspeed-hq]

Merging this PR will improve performance by 3.67%

⚠️ Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 1 improved benchmark
✅ 7 untouched benchmarks

Performance Changes

	Benchmark	BASE	HEAD	Efficiency
⚡	test_compile_stateful[_stateful_page]	150.9 µs	145.6 µs	+3.67%

---

_{Comparing implement-reflex-docgen (f1d63ee) with main (fbcae95)}

[greptile-apps]

Greptile Summary

This PR introduces a new reflex-docgen sub-package and the underlying infrastructure to support programmatic documentation generation for Reflex components. It adds a doc parameter to ComponentField and the field() helper, then migrates ~95 component files from inline # comment style prop descriptions to field(doc="...") kwargs so those descriptions are available at runtime via get_js_fields(). The new generate_documentation() entry-point returns a structured ComponentDocumentation dataclass containing per-prop PropDocumentation objects.

Key changes:

• New packages/reflex-docgen package with generate_documentation() / get_component_props() public API
• ComponentField gains a doc: str | None attribute and BaseComponentMeta now correctly propagates is_javascript and default when rebuilding fields from a bare field(doc=...) call (fixing a pre-existing gap where is_javascript=None could be stored unchecked)
• uv.lock and pyi_hashes.json updated accordingly; monorepo workspace expanded to include packages/*
• One minor code-quality issue: four imports in __init__.py (get_type_hints, AnnotationSource, InspectedAnnotation, inspect_annotation) are unused, left over from an earlier implementation that parsed Annotated[..., Doc(...)] type hints directly

Confidence Score: 4/5

• Safe to merge after cleaning up four unused imports in the new package's init.py.
• The core logic is straightforward and well-scoped. The component-field migration is mechanical and low-risk. The only notable issue is four unused imports that are dead code from an earlier implementation; everything else looks correct and consistent.
• packages/reflex-docgen/src/reflex_docgen/init.py — contains unused imports that should be removed before merging.

Important Files Changed

Filename	Overview
packages/reflex-docgen/src/reflex_docgen/init.py	New docgen module that generates ComponentDocumentation from get_js_fields(); contains four unused imports leftover from a previous implementation.
packages/reflex-docgen/pyproject.toml	New package definition for reflex-docgen with appropriate dependencies (reflex, typing-extensions, typing-inspection).
reflex/components/component.py	Adds doc parameter to ComponentField and field(), fixes is_javascript/default propagation in BaseComponentMeta, and migrates several inline comments to doc= kwargs; a handful of non-JS fields (library, tag, alias, is_default) retain the old comment style.
pyproject.toml	Adds [tool.uv.workspace] section to include packages/* members, integrating the new reflex-docgen package into the monorepo.
pyi_hashes.json	Hash updates for all regenerated .pyi stub files as expected after the component field signature changes.

Sequence Diagram

sequenceDiagram
    participant Caller
    participant generate_documentation
    participant get_component_props
    participant ComponentClass
    participant ComponentField

    Caller->>generate_documentation: generate_documentation(MyComponent)
    generate_documentation->>get_component_props: get_component_props(MyComponent)
    get_component_props->>ComponentClass: get_js_fields()
    ComponentClass-->>get_component_props: Mapping[str, ComponentField]
    loop For each (prop_name, component_field)
        get_component_props->>ComponentField: .doc
        ComponentField-->>get_component_props: doc string or None
        Note over get_component_props: Split doc on "Defaults to" / "Default:"<br/>to extract default_value
        get_component_props->>ComponentField: .type_
        ComponentField-->>get_component_props: type annotation
        get_component_props->>get_component_props: Build PropDocumentation
    end
    get_component_props-->>generate_documentation: tuple[PropDocumentation, ...]
    generate_documentation-->>Caller: ComponentDocumentation(name, props)

Loading

_{Last reviewed commit: "migrate reflex compo..."}

[adhami3310]

@greptileai do your thing