reflex-reactbits 0.1.1__tar.gz

reflex_reactbits-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ernesto Crespo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

reflex_reactbits-0.1.1/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: reflex-reactbits
+Version: 0.1.1
+Summary: Reflex wrappers for React Bits: 200+ animated text effects, backgrounds, UI components and micro interactions.
+Author-email: Ernesto Crespo <ecrespo@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/ecrespo/reflex-reactbits
+Project-URL: Source, https://github.com/ecrespo/reflex-reactbits
+Project-URL: Issues, https://github.com/ecrespo/reflex-reactbits/issues
+Project-URL: React Bits, https://reactbits.dev
+Keywords: reflex,reflex-custom-components,react-bits,reactbits,animations,ui
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Software Development :: Widget Sets
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: reflex>=0.9.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Dynamic: license-file
+
+# reflex-reactbits
+
+[Reflex](https://reflex.dev) wrappers for **[React Bits](https://reactbits.dev)** — the
+open-source collection of animated, interactive and customizable React components by
+David Haz. Every one of the **202 React Bits components** (plus 4 sub-components) is
+available as a typed Python component: text animations, animations, UI components,
+animated WebGL backgrounds and the new *Micro* interactions.
+
+```python
+import reflex as rx
+import reflex_reactbits as rb
+
+
+class State(rx.State):
+    liked: bool = False
+
+    @rx.event
+    def toggle(self, liked: bool, count: int):
+        self.liked = liked
+
+
+def index():
+    return rx.box(
+        rx.box(rb.aurora(color_stops=["#3A29FF", "#FF94B4", "#FF3232"], amplitude=1.0),
+               position="absolute", inset="0"),
+        rb.blur_text(text="Hello from Reflex", animate_by="words", delay=120),
+        rb.pulse_heart(count=128, on_change=State.toggle),
+        position="relative", height="100vh",
+    )
+```
+
+## Installation
+
+```bash
+pip install reflex-reactbits      # or: uv add reflex-reactbits
+```
+
+Requires `reflex>=0.9`.
+
+## How it works (and why the JS is not bundled)
+
+React Bits is distributed as **source code you copy into your project** (via the
+`shadcn`/`jsrepo` CLIs or by hand), not as an npm package, and its license
+(MIT + Commons Clause) does not allow redistributing the components themselves in a
+bundle. So this package ships only the Python side:
+
+1. Each wrapper knows the React Bits category, files and npm dependencies of its component.
+2. The first time you use a component, its original JS-CSS source is copied into your
+   app at `assets/reactbits/<Category>/<Name>/` — the same thing `npx shadcn add` does in
+   a React project. The files are pinned to the React Bits commit these wrappers were
+   generated from.
+3. Reflex imports that file client-side only (`NoSSRComponent`) and installs the exact npm
+   versions React Bits is locked to (`motion`, `gsap`, `ogl`, `three`, ...).
+
+The copied files belong to your app: **edit them freely**, they are never overwritten.
+Commit them if you want reproducible offline builds.
+
+Sources are resolved from `REACTBITS_SOURCE_DIR` (a local clone of
+[DavidHDev/react-bits](https://github.com/DavidHDev/react-bits)) when set, otherwise from
+GitHub raw files at `REACTBITS_REF` (defaults to the pinned commit).
+
+A few tiny patches make the plain JS-CSS variant work without React Router, Chakra UI
+or Tailwind (`PillNav` uses `<a href>`, `ElasticSlider` renders the `react-icons`
+directly, `BlurText` uses inline styles, `Lanyard` imports its `.glb` with `?url`).
+
+## The `reactbits` CLI
+
+```bash
+reactbits list [--category Backgrounds]   # every component and its factory name
+reactbits info pulse_heart                # props, types, defaults, events, npm deps
+reactbits add BlurText Aurora             # copy sources into ./assets/reactbits now
+reactbits add --all                       # vendor all components (offline / CI builds)
+reactbits remove Aurora
+```
+
+## Props, events and children
+
+* Props use snake_case and are converted to the React prop names (`animate_by` → `animateBy`,
+  `sim_resolution` → `SIM_RESOLUTION`, `from_` → `from`). Unset props keep React Bits' defaults.
+* Every prop is typed and documented (hover it in your editor, or run `reactbits info`).
+  Numbers accept `int` and `float`; `ReactNode` props accept strings or Reflex components.
+* Lists/dicts may contain Reflex components, e.g. dock icons:
+  `rb.dock(items=[{"icon": rx.icon("house"), "label": "Home"}])`.
+* Callbacks are Reflex event triggers with the right arity — `on_change` of `rubber_segment`
+  gives `(value, index)`, `on_send` of `prompt_bar` gives `(text, options)`, and so on.
+  Payloads are sanitized before they are sent (React elements, DOM events and functions are
+  dropped, `File`s become metadata), so every React Bits callback is safe to bind.
+* JS-function props (easing curves, custom renderers) take a JS expression:
+  `rb.blur_text(text="Hi", easing=rx.Var("(t) => t * t"))`.
+* Wrapper components take Reflex children: `rb.fade_content(rx.text("Hi"), blur=True)`.
+* Sub-components: `rb.stepper(rb.step(...), ...)`, `rb.card_swap(rb.card_swap_card(...))`,
+  `rb.scroll_stack(rb.scroll_stack_item(...))`, `rb.warm_tooltip_group(...)`.
+* `rb.hyperspeed(preset="three")` uses React Bits' built-in presets.
+* Backgrounds and canvas effects fill their parent: give the parent a size and
+  `position="relative"`.
+
+`rb.CATALOG` / `rb.find_component()` expose the full metadata (props, types, events,
+docs URL, npm deps) at runtime.
+
+## Components
+
+**Text animations (32):** `ascii_text`, `blur_text`, `circular_text`, `count_up`, `curved_loop`, `decrypted_text`, `depth_text`, `echo_text`, `falling_text`, `fold_text`, `fuzzy_text`, `glitch_text`, `gradient_text`, `masked_heading`, `particle_text`, `rotating_text`, `scrambled_text`, `scroll_float`, `scroll_reveal`, `scroll_velocity`, `shiny_text`, `shuffle`, `split_flap_text`, `split_text`, `stroke_text`, `text_cursor`, `text_loop`, `text_pressure`, `text_type`, `true_focus`, `variable_proximity`, `warp_text`
+
+**Animations (38):** `animated_content`, `antigravity`, `blob_cursor`, `click_spark`, `crosshair`, `cubes`, `cursor_grid`, `elastic_mesh`, `electric_border`, `fade_content`, `ghost_cursor`, `glare_hover`, `glow_cursor`, `gradual_blur`, `halftone_reveal`, `image_trail`, `laser_flow`, `logo_loop`, `magic_rings`, `magnet`, `magnet_lines`, `meta_balls`, `metallic_paint`, `noise`, `orbit_images`, `pixel_swap`, `pixel_trail`, `pixel_transition`, `ribbons`, `ripple_distortion`, `scroll_expand`, `shape_blur`, `splash_cursor`, `star_border`, `sticker_peel`, `strands`, `swarm_cursor`, `target_cursor`
+
+**Components (45 + 3 sub-components):** `accordion_gallery`, `animated_list`, `border_glow`, `bounce_cards`, `bubble_menu`, `card_nav`, `card_swap`, `card_swap_card`, `carousel`, `chroma_grid`, `circular_gallery`, `counter`, `curved_input`, `decay_card`, `depth_carousel`, `dock`, `dome_gallery`, `drift_wall`, `elastic_slider`, `flowing_menu`, `fluid_glass`, `flying_posters`, `folder`, `glass_icons`, `glass_surface`, `gooey_nav`, `infinite_menu`, `infinite_spiral`, `lanyard`, `line_sidebar`, `magic_bento`, `masonry`, `model_viewer`, `morph_slider`, `option_wheel`, `pill_nav`, `pixel_card`, `profile_card`, `reflective_card`, `scroll_stack`, `scroll_stack_item`, `specular_button`, `spotlight_card`, `stack`, `staggered_menu`, `stepper`, `step`, `tilted_card`
+
+**Backgrounds (57):** `acid_squares`, `aero_shards`, `aurora`, `balatro`, `ballpit`, `beams`, `crt_warp`, `color_bends`, `dark_veil`, `dither`, `dot_field`, `dot_grid`, `evil_eye`, `faulty_terminal`, `ferrofluid`, `floating_lines`, `galaxy`, `ghost_fibers`, `gradient_blinds`, `gradient_waves`, `grainient`, `grid_distortion`, `grid_motion`, `grid_scan`, `hyperspeed`, `iridescence`, `letter_glitch`, `light_pillar`, `light_rays`, `light_tunnel`, `lightfall`, `lightning`, `line_waves`, `liquid_chrome`, `liquid_ether`, `molten_metal`, `orb`, `particles`, `pixel_blast`, `pixel_snow`, `plasma`, `plasma_wave`, `prism`, `prismatic_burst`, `radar`, `ripple_grid`, `scanner`, `shape_grid`, `shape_waves`, `side_rays`, `silk`, `sliced_waves`, `soft_aurora`, `threads`, `topography`, `waves`, `web_threads`
+
+**Micro interactions (30 + 1 sub-component):** `bell_toggle`, `branched_menu`, `call_chip`, `code_slots`, `comet_dial`, `dodge_field`, `folder_float`, `fuse_button`, `glide_select`, `hold_button`, `jelly_radio`, `lattice_loader`, `peek_rating`, `prompt_bar`, `pulse_heart`, `refine_frame`, `rubber_segment`, `scrub_field`, `slide_commit`, `sling_button`, `slosh_gauge`, `spring_check`, `squish_switch`, `status_mark`, `swipe_row`, `swipe_toast`, `thought_line`, `voice_pill`, `wake_slider`, `warm_tooltip`, `warm_tooltip_group`
+
+Full docs, previews and prop descriptions for each component live at
+[reactbits.dev](https://reactbits.dev).
+
+## Demo app
+
+`reactbits_demo/` is a gallery with a page per component (live preview, replay, event
+log wired to Reflex state, generated Python usage and the props table), a playground
+where props are bound to state vars, and a landing page built only with React Bits.
+
+```bash
+uv sync --extra dev
+cd reactbits_demo
+uv run reflex run
+```
+
+## Regenerating the wrappers
+
+The wrappers are generated from the React Bits sources, so new React Bits releases can be
+picked up automatically:
+
+```bash
+git clone https://github.com/DavidHDev/react-bits /tmp/react-bits
+(cd scripts && npm install)
+node scripts/extract_metadata.mjs /tmp/react-bits scripts/components.json
+python scripts/generate_wrappers.py scripts/components.json /tmp/react-bits
+```
+
+Update `PINNED_REF` in `custom_components/reflex_reactbits/source.py` to the new commit.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run pytest
+# type stubs (.pyi) for editor autocomplete, then sdist + wheel in dist/
+(cd custom_components && uv run python -c "from reflex_base.utils.pyi_generator import PyiGenerator; PyiGenerator().scan_all(['reflex_reactbits'])")
+uv build
+```
+
+## Continuous integration
+
+Three workflows run in `.github/workflows/`:
+
+| Workflow | Runs on | What it checks |
+| --- | --- | --- |
+| `quality.yml` | push and PR to `main`/`develop` | `ruff check`; `pytest` on Python 3.10-3.13; builds the sdist and wheel, runs `twine check`, and fails if any React Bits source slipped into the distribution or into git |
+| `security.yml` | push, PR, and weekly | `pip-audit` on the dependency tree, `bandit` over the hand-written modules, `gitleaks` over the full history, CodeQL, and a dependency review on PRs |
+
+The dependency-review job needs GitHub's dependency graph to be provisioned for the
+repository, which it is not yet: until you enable it at *Settings → Code security →
+Dependency graph*, that job reports "not supported on this repository" and is marked
+`continue-on-error` so it cannot block a merge. Drop that line once it is on. Vulnerable
+dependencies are caught by `pip-audit` regardless; the job only adds the diff of what a
+given pull request introduces.
+| `release.yml` | a `v*` tag, or manually | Rebuilds, refuses a tag that disagrees with the version in `pyproject.toml`, publishes a GitHub release and uploads to PyPI |
+
+## Releasing
+
+```bash
+# 1. bump the version
+$EDITOR pyproject.toml          # [project] version = "0.2.0"
+
+# 2. tag it; the tag must match that version or release.yml stops
+git tag v0.2.0 && git push origin v0.2.0
+```
+
+The tag triggers `release.yml`, which builds, creates the GitHub release with the
+artifacts attached, and uploads to PyPI. `workflow_dispatch` runs the same thing on
+demand and can target TestPyPI instead.
+
+
+## License
+
+The Python wrappers in this repository are MIT licensed (see `LICENSE`).
+React Bits itself is © David Haz under the
+[MIT + Commons Clause license](https://github.com/DavidHDev/react-bits/blob/main/LICENSE.md):
+you may use the components in your applications, including commercially, but not sell or
+redistribute the components themselves. That is why their source is fetched into your
+app instead of being bundled here. This project is not affiliated with React Bits.

reflex_reactbits-0.1.1/README.md

@@ -0,0 +1,190 @@
+# reflex-reactbits
+
+[Reflex](https://reflex.dev) wrappers for **[React Bits](https://reactbits.dev)** — the
+open-source collection of animated, interactive and customizable React components by
+David Haz. Every one of the **202 React Bits components** (plus 4 sub-components) is
+available as a typed Python component: text animations, animations, UI components,
+animated WebGL backgrounds and the new *Micro* interactions.
+
+```python
+import reflex as rx
+import reflex_reactbits as rb
+
+
+class State(rx.State):
+    liked: bool = False
+
+    @rx.event
+    def toggle(self, liked: bool, count: int):
+        self.liked = liked
+
+
+def index():
+    return rx.box(
+        rx.box(rb.aurora(color_stops=["#3A29FF", "#FF94B4", "#FF3232"], amplitude=1.0),
+               position="absolute", inset="0"),
+        rb.blur_text(text="Hello from Reflex", animate_by="words", delay=120),
+        rb.pulse_heart(count=128, on_change=State.toggle),
+        position="relative", height="100vh",
+    )
+```
+
+## Installation
+
+```bash
+pip install reflex-reactbits      # or: uv add reflex-reactbits
+```
+
+Requires `reflex>=0.9`.
+
+## How it works (and why the JS is not bundled)
+
+React Bits is distributed as **source code you copy into your project** (via the
+`shadcn`/`jsrepo` CLIs or by hand), not as an npm package, and its license
+(MIT + Commons Clause) does not allow redistributing the components themselves in a
+bundle. So this package ships only the Python side:
+
+1. Each wrapper knows the React Bits category, files and npm dependencies of its component.
+2. The first time you use a component, its original JS-CSS source is copied into your
+   app at `assets/reactbits/<Category>/<Name>/` — the same thing `npx shadcn add` does in
+   a React project. The files are pinned to the React Bits commit these wrappers were
+   generated from.
+3. Reflex imports that file client-side only (`NoSSRComponent`) and installs the exact npm
+   versions React Bits is locked to (`motion`, `gsap`, `ogl`, `three`, ...).
+
+The copied files belong to your app: **edit them freely**, they are never overwritten.
+Commit them if you want reproducible offline builds.
+
+Sources are resolved from `REACTBITS_SOURCE_DIR` (a local clone of
+[DavidHDev/react-bits](https://github.com/DavidHDev/react-bits)) when set, otherwise from
+GitHub raw files at `REACTBITS_REF` (defaults to the pinned commit).
+
+A few tiny patches make the plain JS-CSS variant work without React Router, Chakra UI
+or Tailwind (`PillNav` uses `<a href>`, `ElasticSlider` renders the `react-icons`
+directly, `BlurText` uses inline styles, `Lanyard` imports its `.glb` with `?url`).
+
+## The `reactbits` CLI
+
+```bash
+reactbits list [--category Backgrounds]   # every component and its factory name
+reactbits info pulse_heart                # props, types, defaults, events, npm deps
+reactbits add BlurText Aurora             # copy sources into ./assets/reactbits now
+reactbits add --all                       # vendor all components (offline / CI builds)
+reactbits remove Aurora
+```
+
+## Props, events and children
+
+* Props use snake_case and are converted to the React prop names (`animate_by` → `animateBy`,
+  `sim_resolution` → `SIM_RESOLUTION`, `from_` → `from`). Unset props keep React Bits' defaults.
+* Every prop is typed and documented (hover it in your editor, or run `reactbits info`).
+  Numbers accept `int` and `float`; `ReactNode` props accept strings or Reflex components.
+* Lists/dicts may contain Reflex components, e.g. dock icons:
+  `rb.dock(items=[{"icon": rx.icon("house"), "label": "Home"}])`.
+* Callbacks are Reflex event triggers with the right arity — `on_change` of `rubber_segment`
+  gives `(value, index)`, `on_send` of `prompt_bar` gives `(text, options)`, and so on.
+  Payloads are sanitized before they are sent (React elements, DOM events and functions are
+  dropped, `File`s become metadata), so every React Bits callback is safe to bind.
+* JS-function props (easing curves, custom renderers) take a JS expression:
+  `rb.blur_text(text="Hi", easing=rx.Var("(t) => t * t"))`.
+* Wrapper components take Reflex children: `rb.fade_content(rx.text("Hi"), blur=True)`.
+* Sub-components: `rb.stepper(rb.step(...), ...)`, `rb.card_swap(rb.card_swap_card(...))`,
+  `rb.scroll_stack(rb.scroll_stack_item(...))`, `rb.warm_tooltip_group(...)`.
+* `rb.hyperspeed(preset="three")` uses React Bits' built-in presets.
+* Backgrounds and canvas effects fill their parent: give the parent a size and
+  `position="relative"`.
+
+`rb.CATALOG` / `rb.find_component()` expose the full metadata (props, types, events,
+docs URL, npm deps) at runtime.
+
+## Components
+
+**Text animations (32):** `ascii_text`, `blur_text`, `circular_text`, `count_up`, `curved_loop`, `decrypted_text`, `depth_text`, `echo_text`, `falling_text`, `fold_text`, `fuzzy_text`, `glitch_text`, `gradient_text`, `masked_heading`, `particle_text`, `rotating_text`, `scrambled_text`, `scroll_float`, `scroll_reveal`, `scroll_velocity`, `shiny_text`, `shuffle`, `split_flap_text`, `split_text`, `stroke_text`, `text_cursor`, `text_loop`, `text_pressure`, `text_type`, `true_focus`, `variable_proximity`, `warp_text`
+
+**Animations (38):** `animated_content`, `antigravity`, `blob_cursor`, `click_spark`, `crosshair`, `cubes`, `cursor_grid`, `elastic_mesh`, `electric_border`, `fade_content`, `ghost_cursor`, `glare_hover`, `glow_cursor`, `gradual_blur`, `halftone_reveal`, `image_trail`, `laser_flow`, `logo_loop`, `magic_rings`, `magnet`, `magnet_lines`, `meta_balls`, `metallic_paint`, `noise`, `orbit_images`, `pixel_swap`, `pixel_trail`, `pixel_transition`, `ribbons`, `ripple_distortion`, `scroll_expand`, `shape_blur`, `splash_cursor`, `star_border`, `sticker_peel`, `strands`, `swarm_cursor`, `target_cursor`
+
+**Components (45 + 3 sub-components):** `accordion_gallery`, `animated_list`, `border_glow`, `bounce_cards`, `bubble_menu`, `card_nav`, `card_swap`, `card_swap_card`, `carousel`, `chroma_grid`, `circular_gallery`, `counter`, `curved_input`, `decay_card`, `depth_carousel`, `dock`, `dome_gallery`, `drift_wall`, `elastic_slider`, `flowing_menu`, `fluid_glass`, `flying_posters`, `folder`, `glass_icons`, `glass_surface`, `gooey_nav`, `infinite_menu`, `infinite_spiral`, `lanyard`, `line_sidebar`, `magic_bento`, `masonry`, `model_viewer`, `morph_slider`, `option_wheel`, `pill_nav`, `pixel_card`, `profile_card`, `reflective_card`, `scroll_stack`, `scroll_stack_item`, `specular_button`, `spotlight_card`, `stack`, `staggered_menu`, `stepper`, `step`, `tilted_card`
+
+**Backgrounds (57):** `acid_squares`, `aero_shards`, `aurora`, `balatro`, `ballpit`, `beams`, `crt_warp`, `color_bends`, `dark_veil`, `dither`, `dot_field`, `dot_grid`, `evil_eye`, `faulty_terminal`, `ferrofluid`, `floating_lines`, `galaxy`, `ghost_fibers`, `gradient_blinds`, `gradient_waves`, `grainient`, `grid_distortion`, `grid_motion`, `grid_scan`, `hyperspeed`, `iridescence`, `letter_glitch`, `light_pillar`, `light_rays`, `light_tunnel`, `lightfall`, `lightning`, `line_waves`, `liquid_chrome`, `liquid_ether`, `molten_metal`, `orb`, `particles`, `pixel_blast`, `pixel_snow`, `plasma`, `plasma_wave`, `prism`, `prismatic_burst`, `radar`, `ripple_grid`, `scanner`, `shape_grid`, `shape_waves`, `side_rays`, `silk`, `sliced_waves`, `soft_aurora`, `threads`, `topography`, `waves`, `web_threads`
+
+**Micro interactions (30 + 1 sub-component):** `bell_toggle`, `branched_menu`, `call_chip`, `code_slots`, `comet_dial`, `dodge_field`, `folder_float`, `fuse_button`, `glide_select`, `hold_button`, `jelly_radio`, `lattice_loader`, `peek_rating`, `prompt_bar`, `pulse_heart`, `refine_frame`, `rubber_segment`, `scrub_field`, `slide_commit`, `sling_button`, `slosh_gauge`, `spring_check`, `squish_switch`, `status_mark`, `swipe_row`, `swipe_toast`, `thought_line`, `voice_pill`, `wake_slider`, `warm_tooltip`, `warm_tooltip_group`
+
+Full docs, previews and prop descriptions for each component live at
+[reactbits.dev](https://reactbits.dev).
+
+## Demo app
+
+`reactbits_demo/` is a gallery with a page per component (live preview, replay, event
+log wired to Reflex state, generated Python usage and the props table), a playground
+where props are bound to state vars, and a landing page built only with React Bits.
+
+```bash
+uv sync --extra dev
+cd reactbits_demo
+uv run reflex run
+```
+
+## Regenerating the wrappers
+
+The wrappers are generated from the React Bits sources, so new React Bits releases can be
+picked up automatically:
+
+```bash
+git clone https://github.com/DavidHDev/react-bits /tmp/react-bits
+(cd scripts && npm install)
+node scripts/extract_metadata.mjs /tmp/react-bits scripts/components.json
+python scripts/generate_wrappers.py scripts/components.json /tmp/react-bits
+```
+
+Update `PINNED_REF` in `custom_components/reflex_reactbits/source.py` to the new commit.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run pytest
+# type stubs (.pyi) for editor autocomplete, then sdist + wheel in dist/
+(cd custom_components && uv run python -c "from reflex_base.utils.pyi_generator import PyiGenerator; PyiGenerator().scan_all(['reflex_reactbits'])")
+uv build
+```
+
+## Continuous integration
+
+Three workflows run in `.github/workflows/`:
+
+| Workflow | Runs on | What it checks |
+| --- | --- | --- |
+| `quality.yml` | push and PR to `main`/`develop` | `ruff check`; `pytest` on Python 3.10-3.13; builds the sdist and wheel, runs `twine check`, and fails if any React Bits source slipped into the distribution or into git |
+| `security.yml` | push, PR, and weekly | `pip-audit` on the dependency tree, `bandit` over the hand-written modules, `gitleaks` over the full history, CodeQL, and a dependency review on PRs |
+
+The dependency-review job needs GitHub's dependency graph to be provisioned for the
+repository, which it is not yet: until you enable it at *Settings → Code security →
+Dependency graph*, that job reports "not supported on this repository" and is marked
+`continue-on-error` so it cannot block a merge. Drop that line once it is on. Vulnerable
+dependencies are caught by `pip-audit` regardless; the job only adds the diff of what a
+given pull request introduces.
+| `release.yml` | a `v*` tag, or manually | Rebuilds, refuses a tag that disagrees with the version in `pyproject.toml`, publishes a GitHub release and uploads to PyPI |
+
+## Releasing
+
+```bash
+# 1. bump the version
+$EDITOR pyproject.toml          # [project] version = "0.2.0"
+
+# 2. tag it; the tag must match that version or release.yml stops
+git tag v0.2.0 && git push origin v0.2.0
+```
+
+The tag triggers `release.yml`, which builds, creates the GitHub release with the
+artifacts attached, and uploads to PyPI. `workflow_dispatch` runs the same thing on
+demand and can target TestPyPI instead.
+
+
+## License
+
+The Python wrappers in this repository are MIT licensed (see `LICENSE`).
+React Bits itself is © David Haz under the
+[MIT + Commons Clause license](https://github.com/DavidHDev/react-bits/blob/main/LICENSE.md):
+you may use the components in your applications, including commercially, but not sell or
+redistribute the components themselves. That is why their source is fetched into your
+app instead of being bundled here. This project is not affiliated with React Bits.

reflex_reactbits-0.1.1/custom_components/reflex_reactbits/__init__.py

@@ -0,0 +1,12 @@
+"""Reflex wrappers for React Bits (https://reactbits.dev)."""
+
+from .animations import *
+from .backgrounds import *
+from .base import ReactBitsComponent
+from .catalog import CATALOG, find_component
+from .components import *
+from .micro import *
+from .source import ensure_component_source
+from .text_animations import *
+
+__all__ = ['CATALOG', 'ASCIIText', 'AccordionGallery', 'AcidSquares', 'AeroShards', 'AnimatedContent', 'AnimatedList', 'Antigravity', 'Aurora', 'Balatro', 'Ballpit', 'Beams', 'BellToggle', 'BlobCursor', 'BlurText', 'BorderGlow', 'BounceCards', 'BranchedMenu', 'BubbleMenu', 'CRTWarp', 'CallChip', 'CardNav', 'CardSwap', 'CardSwapCard', 'Carousel', 'ChromaGrid', 'CircularGallery', 'CircularText', 'ClickSpark', 'CodeSlots', 'ColorBends', 'CometDial', 'CountUp', 'Counter', 'Crosshair', 'Cubes', 'CursorGrid', 'CurvedInput', 'CurvedLoop', 'DarkVeil', 'DecayCard', 'DecryptedText', 'DepthCarousel', 'DepthText', 'Dither', 'Dock', 'DodgeField', 'DomeGallery', 'DotField', 'DotGrid', 'DriftWall', 'EchoText', 'ElasticMesh', 'ElasticSlider', 'ElectricBorder', 'EvilEye', 'FadeContent', 'FallingText', 'FaultyTerminal', 'Ferrofluid', 'FloatingLines', 'FlowingMenu', 'FluidGlass', 'FlyingPosters', 'FoldText', 'Folder', 'FolderFloat', 'FuseButton', 'FuzzyText', 'Galaxy', 'GhostCursor', 'GhostFibers', 'GlareHover', 'GlassIcons', 'GlassSurface', 'GlideSelect', 'GlitchText', 'GlowCursor', 'GooeyNav', 'GradientBlinds', 'GradientText', 'GradientWaves', 'GradualBlur', 'Grainient', 'GridDistortion', 'GridMotion', 'GridScan', 'HalftoneReveal', 'HoldButton', 'Hyperspeed', 'ImageTrail', 'InfiniteMenu', 'InfiniteSpiral', 'Iridescence', 'JellyRadio', 'Lanyard', 'LaserFlow', 'LatticeLoader', 'LetterGlitch', 'LightPillar', 'LightRays', 'LightTunnel', 'Lightfall', 'Lightning', 'LineSidebar', 'LineWaves', 'LiquidChrome', 'LiquidEther', 'LogoLoop', 'MagicBento', 'MagicRings', 'Magnet', 'MagnetLines', 'MaskedHeading', 'Masonry', 'MetaBalls', 'MetallicPaint', 'ModelViewer', 'MoltenMetal', 'MorphSlider', 'Noise', 'OptionWheel', 'Orb', 'OrbitImages', 'ParticleText', 'Particles', 'PeekRating', 'PillNav', 'PixelBlast', 'PixelCard', 'PixelSnow', 'PixelSwap', 'PixelTrail', 'PixelTransition', 'Plasma', 'PlasmaWave', 'Prism', 'PrismaticBurst', 'ProfileCard', 'PromptBar', 'PulseHeart', 'Radar', 'ReactBitsComponent', 'RefineFrame', 'ReflectiveCard', 'Ribbons', 'RippleDistortion', 'RippleGrid', 'RotatingText', 'RubberSegment', 'Scanner', 'ScrambledText', 'ScrollExpand', 'ScrollFloat', 'ScrollReveal', 'ScrollStack', 'ScrollStackItem', 'ScrollVelocity', 'ScrubField', 'ShapeBlur', 'ShapeGrid', 'ShapeWaves', 'ShinyText', 'Shuffle', 'SideRays', 'Silk', 'SlicedWaves', 'SlideCommit', 'SlingButton', 'SloshGauge', 'SoftAurora', 'SpecularButton', 'SplashCursor', 'SplitFlapText', 'SplitText', 'SpotlightCard', 'SpringCheck', 'SquishSwitch', 'Stack', 'StaggeredMenu', 'StarBorder', 'StatusMark', 'Step', 'Stepper', 'StickerPeel', 'Strands', 'StrokeText', 'SwarmCursor', 'SwipeRow', 'SwipeToast', 'TargetCursor', 'TextCursor', 'TextLoop', 'TextPressure', 'TextType', 'ThoughtLine', 'Threads', 'TiltedCard', 'Topography', 'TrueFocus', 'VariableProximity', 'VoicePill', 'WakeSlider', 'WarmTooltip', 'WarmTooltipGroup', 'WarpText', 'Waves', 'WebThreads', 'accordion_gallery', 'acid_squares', 'aero_shards', 'animated_content', 'animated_list', 'antigravity', 'ascii_text', 'aurora', 'balatro', 'ballpit', 'beams', 'bell_toggle', 'blob_cursor', 'blur_text', 'border_glow', 'bounce_cards', 'branched_menu', 'bubble_menu', 'call_chip', 'card_nav', 'card_swap', 'card_swap_card', 'carousel', 'chroma_grid', 'circular_gallery', 'circular_text', 'click_spark', 'code_slots', 'color_bends', 'comet_dial', 'count_up', 'counter', 'crosshair', 'crt_warp', 'cubes', 'cursor_grid', 'curved_input', 'curved_loop', 'dark_veil', 'decay_card', 'decrypted_text', 'depth_carousel', 'depth_text', 'dither', 'dock', 'dodge_field', 'dome_gallery', 'dot_field', 'dot_grid', 'drift_wall', 'echo_text', 'elastic_mesh', 'elastic_slider', 'electric_border', 'ensure_component_source', 'evil_eye', 'fade_content', 'falling_text', 'faulty_terminal', 'ferrofluid', 'find_component', 'floating_lines', 'flowing_menu', 'fluid_glass', 'flying_posters', 'fold_text', 'folder', 'folder_float', 'fuse_button', 'fuzzy_text', 'galaxy', 'ghost_cursor', 'ghost_fibers', 'glare_hover', 'glass_icons', 'glass_surface', 'glide_select', 'glitch_text', 'glow_cursor', 'gooey_nav', 'gradient_blinds', 'gradient_text', 'gradient_waves', 'gradual_blur', 'grainient', 'grid_distortion', 'grid_motion', 'grid_scan', 'halftone_reveal', 'hold_button', 'hyperspeed', 'image_trail', 'infinite_menu', 'infinite_spiral', 'iridescence', 'jelly_radio', 'lanyard', 'laser_flow', 'lattice_loader', 'letter_glitch', 'light_pillar', 'light_rays', 'light_tunnel', 'lightfall', 'lightning', 'line_sidebar', 'line_waves', 'liquid_chrome', 'liquid_ether', 'logo_loop', 'magic_bento', 'magic_rings', 'magnet', 'magnet_lines', 'masked_heading', 'masonry', 'meta_balls', 'metallic_paint', 'model_viewer', 'molten_metal', 'morph_slider', 'noise', 'option_wheel', 'orb', 'orbit_images', 'particle_text', 'particles', 'peek_rating', 'pill_nav', 'pixel_blast', 'pixel_card', 'pixel_snow', 'pixel_swap', 'pixel_trail', 'pixel_transition', 'plasma', 'plasma_wave', 'prism', 'prismatic_burst', 'profile_card', 'prompt_bar', 'pulse_heart', 'radar', 'refine_frame', 'reflective_card', 'ribbons', 'ripple_distortion', 'ripple_grid', 'rotating_text', 'rubber_segment', 'scanner', 'scrambled_text', 'scroll_expand', 'scroll_float', 'scroll_reveal', 'scroll_stack', 'scroll_stack_item', 'scroll_velocity', 'scrub_field', 'shape_blur', 'shape_grid', 'shape_waves', 'shiny_text', 'shuffle', 'side_rays', 'silk', 'sliced_waves', 'slide_commit', 'sling_button', 'slosh_gauge', 'soft_aurora', 'specular_button', 'splash_cursor', 'split_flap_text', 'split_text', 'spotlight_card', 'spring_check', 'squish_switch', 'stack', 'staggered_menu', 'star_border', 'status_mark', 'step', 'stepper', 'sticker_peel', 'strands', 'stroke_text', 'swarm_cursor', 'swipe_row', 'swipe_toast', 'target_cursor', 'text_cursor', 'text_loop', 'text_pressure', 'text_type', 'thought_line', 'threads', 'tilted_card', 'topography', 'true_focus', 'variable_proximity', 'voice_pill', 'wake_slider', 'warm_tooltip', 'warm_tooltip_group', 'warp_text', 'waves', 'web_threads']