dioxus-hoverfx-core 0.1.0-alpha.3

Serializable worker-first cursor hover effect configuration for Dioxus.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

# dioxus-hoverfx-core

Serializable configuration for worker-first cursor proximity hover effects.

```rust
use dioxus_hoverfx_core::{
    HoverFxConfig, HoverFxDefinition, HoverFxFalloff, HoverFxPreset, HoverFxShape,
};

let config = HoverFxConfig::new()
    .with_default_effect(HoverFxPreset::Spotlight.as_attr())
    .with_radius_px(220)
    .with_shape(HoverFxShape::Circle)
    .with_falloff(HoverFxFalloff::Smooth)
    .with_strength(1.15)
    .with_effect(
        HoverFxDefinition::new("brand-wash", "Brand wash")
            .with_preset(HoverFxPreset::ColorWash)
            .with_css_var("--dxh-color", "rgba(14,165,233,0.30)")
            .with_css_var("--dxh-blend-mode", "screen"),
    );

assert!(config.validate().is_valid());
let json = serde_json::to_string(&config)?;
# Ok::<(), serde_json::Error>(())
```

Built-in presets are `spotlight`, `soft-glow`, `border-trace`, `sheen`, and
`color-wash`. Defaults are tuned for worker-first rendering: 180px radius,
smooth falloff, 1.0 strength, 0.18 pointer smoothing, and up to 8 active
elements per frame.

## Install

~~~toml
[dependencies]
dioxus-hoverfx-core = "0.1.0-alpha.3"
~~~

## Release Status

- Current crate version: `0.1.0-alpha.3`.
- Release wave: June 8, 2026 workspace integration update.
- Publish status: Prepared as a crates.io update for this package.
- Scope: Serializable worker-first cursor hover effect configuration for Dioxus.
- The README install examples and local workspace dependency requirements are aligned with this publish wave.

## Integration Recipes

Route-level integrations can build one manifest and reuse it across SSR,
Strata-style route metadata, asset-budget reports, and optimizer caches:

```rust
use dioxus_hoverfx_core::prelude::*;

let config = hoverfx().with_default_effect(HoverFxPreset::Spotlight.as_attr());
let policy = hoverfx_route_policy()
    .route("/gallery")
    .diagnostics(HoverFxDiagnosticVerbosity::Summary)
    .fallback(HoverFxFallbackStrategy::StaticCss);

let manifest = hoverfx_manifest_fragment(&config, &policy);
let batch = hoverfx_serialize_batch([(&config, policy.clone())], HoverFxBatchOptions::default())?;
let budget = hoverfx_asset_budget_bridge(&config.output_report(&policy));
let migration = hoverfx_strata_migration_plan(&config, &policy);

assert_eq!(manifest.package, "dioxus-hoverfx");
assert!(batch.total_bytes > 0);
assert!(budget.categories.iter().any(|category| category.name == "runtime"));
assert!(migration.steps.iter().any(|step| step.contains("Strata")));
# Ok::<(), serde_json::Error>(())
```

For deterministic build output, use `HoverFxBatchOptions { deterministic_parallel:
true, ..Default::default() }`. `HoverFxRuntimeIds::duplicate_ids` and
`deduped` guard generated script/style ids, `hoverfx_optimizer_artifacts`
returns minifier/cache-friendly hashes, and `hoverfx_workertown_offload_plan`
describes serializable off-main-thread tasks.