canonrs-server 0.1.0

CanonRS server-side rendering support
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

id: sidebar
label: Sidebar
family: family-d-navigation
category: Navigation
intent: Vertical navigation panel
description: Sidebar navigation component
composable: true
capabilities: OpenClose
required_parts: ["SidebarContent"]
optional_parts: ["SidebarHeader", "SidebarFooter", "SidebarMenu", "SidebarMenuItem"]
tags: ["sidebar", "nav", "navigation", "links", "left-panel"]
keywords: 
pain: Sidebars lose active state, disabled links and structural consistency
promise: Navigation state and structure enforced at component level
why: |
  SidebarPrimitive encodes visibility, variant and navigation semantics. Menu items derive active and disabled states automatically. This guarantees consistent navigation behavior.
rules: ["CR-001", "CR-004"]
use_cases: ["app navigation", "admin panels"]
related: ["navigation_menu", "nav_item", "breadcrumb", "pagination", "link_group"]
file: sidebar_ui.css
tokens: sidebar-*, badge-*, size-*, space-*, radius-*, font-*
foundation: spacing, size, radius, typography
states: ["open", "closed", "active", "disabled"]
island: sidebar_boundary.rs
pillar: navigation
badges: ["SSR Safe", "Hydration Safe", "Token Driven", "Deterministic API", "Zero Drift", "Island Architecture"]
before: |
  // ❌ Typical
  view! {
    <aside>
      <a class="active">"Home"</a>
    </aside>
  }
after: |
  // ✅ CanonRS
  view! {
    <Sidebar>
      <SidebarMenu>
        <SidebarMenuItem active=ActivityState::Active href="/">"Home"</SidebarMenuItem>
      </SidebarMenu>
    </Sidebar>
  }
boundary_type: interaction
ix_group: ix_nav
block: []
blocks_primitives: [flex]