nexus-stratum-core 0.1.0

Core traits and types for NexusStratum UI component library
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

# stratum-core

## Purpose

Foundation crate providing the core traits, types, and utilities that all other NexusStratum crates depend on.

## Position in Pipeline

```
                        stratum-core
                             |
        +----------+---------+----------+---------+----------+
        |          |         |          |         |          |
   stratum-a11y  theme     css      tailwind   icons    security
        |          |         |          |         |
   primitives  components  css     tailwind    icons
        |          |                    |         |
   components  leptos/dioxus       components  leptos/dioxus
```

No dependencies on other stratum crates. Used by every other crate in the workspace.

## Key Public API

| Item | Description |
|------|-------------|
| `Component` trait | Base trait all components implement |
| `Props` trait | Trait for component property structs |
| `ComponentEvent` | Unified event type for component interactions |
| `AriaAttributes` | Struct for WAI-ARIA attribute management |
| `AriaRole` | Enum of ARIA roles |
| `FocusManager` | Utility for managing focus state across components |
| `IdGenerator` | Deterministic unique ID generation for SSR compatibility |
| `RenderOutput` | Framework-agnostic render output type |

## Usage Example

```rust
use stratum_core::{Component, Props, AriaRole, IdGenerator};

#[derive(Props)]
struct MyButtonProps {
    label: String,
    disabled: bool,
}

struct MyButton;

impl Component for MyButton {
    type Props = MyButtonProps;

    fn render(props: &Self::Props) -> RenderOutput {
        let id = IdGenerator::next("my-button");
        RenderOutput::new("button")
            .aria_role(AriaRole::Button)
            .attr("id", &id)
            .text(&props.label)
    }
}
```

## How to Run Tests

```bash
cargo test -p stratum-core
```