reflex-reactbits 0.1.1__tar.gz → 0.2.1__tar.gz

{reflex_reactbits-0.1.1 → reflex_reactbits-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reflex-reactbits
-Version: 0.1.1
+Version: 0.2.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
@@ -35,7 +35,7 @@ Dynamic: license-file
 
 [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
+David Haz. Every one of the **218 React Bits 2.0 components** (plus 5 sub-components) is
 available as a typed Python component: text animations, animations, UI components,
 animated WebGL backgrounds and the new *Micro* interactions.
 
@@ -92,9 +92,16 @@ 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`).
+React Bits 2.0 no longer needs React Router, Chakra UI or Tailwind, so the sources are
+copied as-is with one exception: components that render their own `<canvas>` keep their
+WebGL context on unmount instead of calling `loseContext()`. React StrictMode (on in Reflex
+dev mode) re-runs effects on the same canvas, and a lost context would leave the component
+frozen or blank.
+
+Each copy records the React Bits commit it came from in `.reactbits-ref`. When a newer
+version of this package is generated from another commit, existing copies are **not**
+replaced (they may hold your edits), but a warning names them and `reactbits add` lists
+them as `stale`.
 
 ## The `reactbits` CLI
 
@@ -106,6 +113,28 @@ reactbits add --all                       # vendor all components (offline / CI
 reactbits remove Aurora
 ```
 
+## Upgrading from 0.1.x (React Bits 1.x → 2.0)
+
+0.2.0 wraps React Bits 2.0, which reworked most components. In short:
+
+* **Props changed** on most components (renamed, removed or added). React ignores unknown
+  props, so check each component's props (`reactbits info <name>`) when upgrading.
+* **Replace the copied sources**: `reactbits add --all --force` in your app (this discards
+  local edits to them), or delete `assets/reactbits/` and let it be re-created.
+* **New components (15):** `circular_carousel`, `crystalized_ball`, `dither_veil`,
+  `electric_logo`, `flex_carousel`, `flip_card`, `flux_lines`, `gradient_ascii`,
+  `holo_card`, `micro_slats`, `paper_crumple`, `pattern_waves`, `shredder`, `tear_ticket`,
+  `tech_text`; and the `tilted_card_layer` sub-component.
+* **Moved to Backgrounds:** `antigravity`, `magic_rings`, `magnet_lines` (same factory names).
+* **Removed APIs:** `rb.hyperspeed(preset=...)` (use `curve`, `boosting`, colour props),
+  `splash_cursor`'s `SIM_RESOLUTION`-style props, Lanyard/FluidGlass `.glb` assets (the 3D
+  geometry is now procedural).
+* **Fewer npm dependencies:** lucide-react, react-icons, Chakra UI, react-router,
+  postprocessing, lenis, maath, meshline, face-api.js and @react-three/rapier are gone;
+  icons come from Hugeicons.
+* A prop named like a Python builtin gets a trailing underscore, like `from_`:
+  `float` → `float_` (`depth_text`, `model_viewer`).
+
 ## Props, events and children
 
 * Props use snake_case and are converted to the React prop names (`animate_by` → `animateBy`,
@@ -123,7 +152,10 @@ reactbits remove Aurora
 * 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.
+* `rb.tilted_card(rb.tilted_card_layer(..., depth=30), ...)` floats content above the card;
+  `rb.step(..., title="Plan")` labels a stepper step.
+* `rb.hyperspeed(curve="racing", boosting=State.loading)` - 2.0 replaced the presets with
+  props.
 * Backgrounds and canvas effects fill their parent: give the parent a size and
   `position="relative"`.
 
@@ -132,15 +164,15 @@ 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`
+**Text animations (33):** `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`, `tech_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`
+**Animations (38):** `animated_content`, `blob_cursor`, `click_spark`, `crosshair`, `crystalized_ball`, `cubes`, `cursor_grid`, `dither_veil`, `elastic_mesh`, `electric_border`, `electric_logo`, `fade_content`, `ghost_cursor`, `glare_hover`, `glow_cursor`, `gradual_blur`, `halftone_reveal`, `image_trail`, `laser_flow`, `logo_loop`, `magnet`, `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`
+**Components (48 + 4 sub-components):** `accordion_gallery`, `animated_list`, `border_glow`, `bounce_cards`, `bubble_menu`, `card_nav`, `card_swap`, `card_swap_card`, `carousel`, `chroma_grid`, `circular_carousel`, `circular_gallery`, `counter`, `curved_input`, `decay_card`, `depth_carousel`, `dock`, `dome_gallery`, `drift_wall`, `elastic_slider`, `flex_carousel`, `flowing_menu`, `fluid_glass`, `flying_posters`, `folder`, `glass_icons`, `glass_surface`, `gooey_nav`, `holo_card`, `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`, `step`, `stepper`, `tilted_card`, `tilted_card_layer`
 
-**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`
+**Backgrounds (64):** `acid_squares`, `aero_shards`, `antigravity`, `aurora`, `balatro`, `ballpit`, `beams`, `color_bends`, `crt_warp`, `dark_veil`, `dither`, `dot_field`, `dot_grid`, `evil_eye`, `faulty_terminal`, `ferrofluid`, `floating_lines`, `flux_lines`, `galaxy`, `ghost_fibers`, `gradient_ascii`, `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`, `magic_rings`, `magnet_lines`, `micro_slats`, `molten_metal`, `orb`, `particles`, `pattern_waves`, `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`
+**Micro interactions (35 + 1 sub-component):** `bell_toggle`, `branched_menu`, `call_chip`, `code_slots`, `comet_dial`, `dodge_field`, `flip_card`, `flying_button`, `folder_float`, `fuse_button`, `glide_select`, `hold_button`, `jelly_radio`, `lattice_loader`, `paper_crumple`, `peek_rating`, `prompt_bar`, `pulse_heart`, `refine_frame`, `rubber_segment`, `scrub_field`, `shredder`, `slide_commit`, `sling_button`, `slosh_gauge`, `spring_check`, `squish_switch`, `status_mark`, `swipe_row`, `swipe_toast`, `tear_ticket`, `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).
@@ -149,7 +181,8 @@ Full docs, previews and prop descriptions for each component live at
 
 `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.
+where props are bound to state vars, a *What's new in 2.0* page with live previews of
+every new component, and a landing page built only with React Bits.
 
 ```bash
 uv sync --extra dev
@@ -170,6 +203,9 @@ 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.
+If `git diff --stat <old> <new> -- src/content` only adds files (new components), add the
+old commit to `COMPATIBLE_REFS` next to it, so copies apps already vendored from it are not
+reported as stale; if any existing component changed, empty that set instead.
 
 ## Development
 
@@ -202,10 +238,10 @@ given pull request introduces.
 
 ```bash
 # 1. bump the version
-$EDITOR pyproject.toml          # [project] version = "0.2.0"
+$EDITOR pyproject.toml          # [project] version = "0.2.1"
 
 # 2. tag it; the tag must match that version or release.yml stops
-git tag v0.2.0 && git push origin v0.2.0
+git tag v0.2.1 && git push origin v0.2.1
 ```
 
 The tag triggers `release.yml`, which builds, creates the GitHub release with the

{reflex_reactbits-0.1.1 → reflex_reactbits-0.2.1}/README.md

@@ -2,7 +2,7 @@
 
 [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
+David Haz. Every one of the **218 React Bits 2.0 components** (plus 5 sub-components) is
 available as a typed Python component: text animations, animations, UI components,
 animated WebGL backgrounds and the new *Micro* interactions.
 
@@ -59,9 +59,16 @@ 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`).
+React Bits 2.0 no longer needs React Router, Chakra UI or Tailwind, so the sources are
+copied as-is with one exception: components that render their own `<canvas>` keep their
+WebGL context on unmount instead of calling `loseContext()`. React StrictMode (on in Reflex
+dev mode) re-runs effects on the same canvas, and a lost context would leave the component
+frozen or blank.
+
+Each copy records the React Bits commit it came from in `.reactbits-ref`. When a newer
+version of this package is generated from another commit, existing copies are **not**
+replaced (they may hold your edits), but a warning names them and `reactbits add` lists
+them as `stale`.
 
 ## The `reactbits` CLI
 
@@ -73,6 +80,28 @@ reactbits add --all                       # vendor all components (offline / CI
 reactbits remove Aurora
 ```
 
+## Upgrading from 0.1.x (React Bits 1.x → 2.0)
+
+0.2.0 wraps React Bits 2.0, which reworked most components. In short:
+
+* **Props changed** on most components (renamed, removed or added). React ignores unknown
+  props, so check each component's props (`reactbits info <name>`) when upgrading.
+* **Replace the copied sources**: `reactbits add --all --force` in your app (this discards
+  local edits to them), or delete `assets/reactbits/` and let it be re-created.
+* **New components (15):** `circular_carousel`, `crystalized_ball`, `dither_veil`,
+  `electric_logo`, `flex_carousel`, `flip_card`, `flux_lines`, `gradient_ascii`,
+  `holo_card`, `micro_slats`, `paper_crumple`, `pattern_waves`, `shredder`, `tear_ticket`,
+  `tech_text`; and the `tilted_card_layer` sub-component.
+* **Moved to Backgrounds:** `antigravity`, `magic_rings`, `magnet_lines` (same factory names).
+* **Removed APIs:** `rb.hyperspeed(preset=...)` (use `curve`, `boosting`, colour props),
+  `splash_cursor`'s `SIM_RESOLUTION`-style props, Lanyard/FluidGlass `.glb` assets (the 3D
+  geometry is now procedural).
+* **Fewer npm dependencies:** lucide-react, react-icons, Chakra UI, react-router,
+  postprocessing, lenis, maath, meshline, face-api.js and @react-three/rapier are gone;
+  icons come from Hugeicons.
+* A prop named like a Python builtin gets a trailing underscore, like `from_`:
+  `float` → `float_` (`depth_text`, `model_viewer`).
+
 ## Props, events and children
 
 * Props use snake_case and are converted to the React prop names (`animate_by` → `animateBy`,
@@ -90,7 +119,10 @@ reactbits remove Aurora
 * 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.
+* `rb.tilted_card(rb.tilted_card_layer(..., depth=30), ...)` floats content above the card;
+  `rb.step(..., title="Plan")` labels a stepper step.
+* `rb.hyperspeed(curve="racing", boosting=State.loading)` - 2.0 replaced the presets with
+  props.
 * Backgrounds and canvas effects fill their parent: give the parent a size and
   `position="relative"`.
 
@@ -99,15 +131,15 @@ 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`
+**Text animations (33):** `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`, `tech_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`
+**Animations (38):** `animated_content`, `blob_cursor`, `click_spark`, `crosshair`, `crystalized_ball`, `cubes`, `cursor_grid`, `dither_veil`, `elastic_mesh`, `electric_border`, `electric_logo`, `fade_content`, `ghost_cursor`, `glare_hover`, `glow_cursor`, `gradual_blur`, `halftone_reveal`, `image_trail`, `laser_flow`, `logo_loop`, `magnet`, `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`
+**Components (48 + 4 sub-components):** `accordion_gallery`, `animated_list`, `border_glow`, `bounce_cards`, `bubble_menu`, `card_nav`, `card_swap`, `card_swap_card`, `carousel`, `chroma_grid`, `circular_carousel`, `circular_gallery`, `counter`, `curved_input`, `decay_card`, `depth_carousel`, `dock`, `dome_gallery`, `drift_wall`, `elastic_slider`, `flex_carousel`, `flowing_menu`, `fluid_glass`, `flying_posters`, `folder`, `glass_icons`, `glass_surface`, `gooey_nav`, `holo_card`, `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`, `step`, `stepper`, `tilted_card`, `tilted_card_layer`
 
-**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`
+**Backgrounds (64):** `acid_squares`, `aero_shards`, `antigravity`, `aurora`, `balatro`, `ballpit`, `beams`, `color_bends`, `crt_warp`, `dark_veil`, `dither`, `dot_field`, `dot_grid`, `evil_eye`, `faulty_terminal`, `ferrofluid`, `floating_lines`, `flux_lines`, `galaxy`, `ghost_fibers`, `gradient_ascii`, `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`, `magic_rings`, `magnet_lines`, `micro_slats`, `molten_metal`, `orb`, `particles`, `pattern_waves`, `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`
+**Micro interactions (35 + 1 sub-component):** `bell_toggle`, `branched_menu`, `call_chip`, `code_slots`, `comet_dial`, `dodge_field`, `flip_card`, `flying_button`, `folder_float`, `fuse_button`, `glide_select`, `hold_button`, `jelly_radio`, `lattice_loader`, `paper_crumple`, `peek_rating`, `prompt_bar`, `pulse_heart`, `refine_frame`, `rubber_segment`, `scrub_field`, `shredder`, `slide_commit`, `sling_button`, `slosh_gauge`, `spring_check`, `squish_switch`, `status_mark`, `swipe_row`, `swipe_toast`, `tear_ticket`, `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).
@@ -116,7 +148,8 @@ Full docs, previews and prop descriptions for each component live at
 
 `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.
+where props are bound to state vars, a *What's new in 2.0* page with live previews of
+every new component, and a landing page built only with React Bits.
 
 ```bash
 uv sync --extra dev
@@ -137,6 +170,9 @@ 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.
+If `git diff --stat <old> <new> -- src/content` only adds files (new components), add the
+old commit to `COMPATIBLE_REFS` next to it, so copies apps already vendored from it are not
+reported as stale; if any existing component changed, empty that set instead.
 
 ## Development
 
@@ -169,10 +205,10 @@ given pull request introduces.
 
 ```bash
 # 1. bump the version
-$EDITOR pyproject.toml          # [project] version = "0.2.0"
+$EDITOR pyproject.toml          # [project] version = "0.2.1"
 
 # 2. tag it; the tag must match that version or release.yml stops
-git tag v0.2.0 && git push origin v0.2.0
+git tag v0.2.1 && git push origin v0.2.1
 ```
 
 The tag triggers `release.yml`, which builds, creates the GitHub release with the

reflex_reactbits-0.2.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', 'CircularCarousel', 'CircularGallery', 'CircularText', 'ClickSpark', 'CodeSlots', 'ColorBends', 'CometDial', 'CountUp', 'Counter', 'Crosshair', 'CrystalizedBall', 'Cubes', 'CursorGrid', 'CurvedInput', 'CurvedLoop', 'DarkVeil', 'DecayCard', 'DecryptedText', 'DepthCarousel', 'DepthText', 'Dither', 'DitherVeil', 'Dock', 'DodgeField', 'DomeGallery', 'DotField', 'DotGrid', 'DriftWall', 'EchoText', 'ElasticMesh', 'ElasticSlider', 'ElectricBorder', 'ElectricLogo', 'EvilEye', 'FadeContent', 'FallingText', 'FaultyTerminal', 'Ferrofluid', 'FlexCarousel', 'FlipCard', 'FloatingLines', 'FlowingMenu', 'FluidGlass', 'FluxLines', 'FlyingButton', 'FlyingPosters', 'FoldText', 'Folder', 'FolderFloat', 'FuseButton', 'FuzzyText', 'Galaxy', 'GhostCursor', 'GhostFibers', 'GlareHover', 'GlassIcons', 'GlassSurface', 'GlideSelect', 'GlitchText', 'GlowCursor', 'GooeyNav', 'GradientASCII', 'GradientBlinds', 'GradientText', 'GradientWaves', 'GradualBlur', 'Grainient', 'GridDistortion', 'GridMotion', 'GridScan', 'HalftoneReveal', 'HoldButton', 'HoloCard', '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', 'MicroSlats', 'ModelViewer', 'MoltenMetal', 'MorphSlider', 'Noise', 'OptionWheel', 'Orb', 'OrbitImages', 'PaperCrumple', 'ParticleText', 'Particles', 'PatternWaves', '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', 'Shredder', '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', 'TearTicket', 'TechText', 'TextCursor', 'TextLoop', 'TextPressure', 'TextType', 'ThoughtLine', 'Threads', 'TiltedCard', 'TiltedCardLayer', '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_carousel', 'circular_gallery', 'circular_text', 'click_spark', 'code_slots', 'color_bends', 'comet_dial', 'count_up', 'counter', 'crosshair', 'crt_warp', 'crystalized_ball', 'cubes', 'cursor_grid', 'curved_input', 'curved_loop', 'dark_veil', 'decay_card', 'decrypted_text', 'depth_carousel', 'depth_text', 'dither', 'dither_veil', 'dock', 'dodge_field', 'dome_gallery', 'dot_field', 'dot_grid', 'drift_wall', 'echo_text', 'elastic_mesh', 'elastic_slider', 'electric_border', 'electric_logo', 'ensure_component_source', 'evil_eye', 'fade_content', 'falling_text', 'faulty_terminal', 'ferrofluid', 'find_component', 'flex_carousel', 'flip_card', 'floating_lines', 'flowing_menu', 'fluid_glass', 'flux_lines', 'flying_button', '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_ascii', 'gradient_blinds', 'gradient_text', 'gradient_waves', 'gradual_blur', 'grainient', 'grid_distortion', 'grid_motion', 'grid_scan', 'halftone_reveal', 'hold_button', 'holo_card', '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', 'micro_slats', 'model_viewer', 'molten_metal', 'morph_slider', 'noise', 'option_wheel', 'orb', 'orbit_images', 'paper_crumple', 'particle_text', 'particles', 'pattern_waves', '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', 'shredder', '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', 'tear_ticket', 'tech_text', 'text_cursor', 'text_loop', 'text_pressure', 'text_type', 'thought_line', 'threads', 'tilted_card', 'tilted_card_layer', 'topography', 'true_focus', 'variable_proximity', 'voice_pill', 'wake_slider', 'warm_tooltip', 'warm_tooltip_group', 'warp_text', 'waves', 'web_threads']