canonrs-core 0.1.0

CanonRS core types, traits and primitives
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

# Floating Primitive - Contracts

## Purpose
Calculate and apply positioning for anchored overlay components (Popover, Tooltip, Dropdown, HoverCard).

## Responsibilities
1. Calculate anchor element position via `getBoundingClientRect()`
2. Compute floating element position based on placement
3. Detect viewport collisions
4. Apply flip strategy when needed
5. Write CSS custom properties: `--floating-x`, `--floating-y`, `--floating-placement`

## Non-Responsibilities
- Visual styling (CSS owns this)
- State management (Controller owns this)
- Animation (CSS transitions own this)

## Architecture
```
Anchor Element (trigger)
    ↓ getBoundingClientRect()
use_floating_position(anchor_id, config)
    ↓ calculates position
CSS vars (--floating-x, --floating-y)
    ↓ consumed by
Overlay CSS (transform: translate())
```

## Usage Example
```rust
use_floating_position(
    "trigger-button",
    FloatingConfig {
        placement: Placement::Bottom,
        offset: 8.0,
        flip: true,
    }
);
```

## Canon Rules Applied
- Rule #166: Overlay Positioning Is Component-Owned (CSS vars, not inline styles)
- Rule #27: SSR/CSR Markup Structurally Identical (no DOM manipulation)
- Rule #169: Token Cascade Is Architecture (CSS vars are the interface)