1# llimphi-widget-wawa-mark
2
3The vector seal of the wawa OS.
4
5## Spec (revision 2026-05-29)
6
7Nominal identity is **implicit**: the background rhombus carries the official
8palette (Indigo Blue / Deep Purple) and the white strokes form the letters
9**"WA"**, but geometrically — they are not typography, they are internal edges
10bouncing at the rhombus's own 45°, which gives the sense of facets carved inside
11the diamond.
12
13### Composition
14
151. **Background rhombus** — an immaculate vertical gradient with no visible seam:
16   indigo on top, purple below. The linear gradient covers the rhombus's whole
17   height (not just half), so the tonal change is continuous.
182. **The "WA" stroke** — a single `BezPath` with two subpaths:
19   - **W** (left): a 4-segment zigzag, all at 45° (matching the rhombus's edges).
20     Peaks on the blue/purple seam (y = 0.50), valleys at y = 0.60. Five
21     vertices, four segments.
22   - **A** (right): an open triangle formed by two 45° legs plus a horizontal
23     crossbar at mid height. Three segments.
24
25   Six of the seven strokes are diagonals parallel to the rhombus's edges, which
26   is why they "read" as edges cut from the diamond rather than letters painted
27   on top.
283. **Merkle Core** — a luminous dot with a halo at the W's central peak (on the
29   seam, where blue and purple meet). It is the root node that ties the system
30   together.
31
32### Geometry (in the rect's normalized `[0, 1] × [0, 1]` coordinates)
33
34```text
35                           Top
36                            ◇
37                           / \
38                          /   \              ← indigo blue
39                         /     \
40               P0    P2★    P4 A1
41                 ●─.   ●  .─●  ●─.  .─●     ← y = 0.50 (seam)
42                    ╲ ╱ ╲ ╱     ╲      ╱
43                     ╳   ╳       ╲────╱     ← A crossbar (y=0.55)
44                    ╱ ╲ ╱ ╲     ╱      ╲
45                 ●─'   ●  '─●  ●─'    '─●  ← y = 0.60 (valleys/feet)
46               P1    P3    A0    A2
47                         ↑
48                         gap between W and A
49    Left  ◇─────────────────────────────────◇  Right
50                         (seam, y = 0.50)
51                         /
52                        /
53                       /                     ← deep purple
54                      /
55                     ◇
56                   Bottom
57```
58
59Every diagonal stroke is at slope ±1, like the rhombus's edges. The A's crossbar
60is the only horizontal — a minimal concession to letter legibility, kept
61subordinate to the diamond pattern.
62
63## Use
64
65```ignore
66use llimphi_widget_wawa_mark::{wawa_mark_view, WawaMarkPalette};
67
68// In a view:
69View::new(Style { size: Size { width: length(128.0), height: length(128.0) }, ..Default::default() })
70    .children(vec![wawa_mark_view(&WawaMarkPalette::default())])
71```
72
73The widget fills the parent's rect — give it a square size so the rhombus is not
74distorted (it honours whatever it gets, but square looks right).
75
76---
77
78Part of **llimphi** — see [llimphi](../../README.md).