cvkg-core

CVKG Hero HUD

cvkg-core defines the fundamental traits, types, and architectural guidelines that power the entire Cyber Viking Kvasir Graph (CVKG) ecosystem.

Boundaries and Responsibilities

This crate provides the abstract definitions for the UI system but does NOT implement specific rendering backends or complex layout algorithms. It focuses on:

The View trait and its modifier-based composition system.
Core geometric types (Rect, Point, Size).
The Renderer trait facade.
Agentic development protocols and knowledge state structures.

Public API Overview

Core Traits

View: The primary building block. Every UI element implements View. It uses a declarative body() method for composition.
Renderer: A trait defining the drawing operations available to primitive views, now supporting full 3x3 affine transformations (push_affine).
ViewModifier: Enables the extension of view behavior and appearance via composition.

Key Structs

Rect, Size, Point: Fundamental geometry primitives.
KnowledgeState: Captures the cognitive state of the agentic system, including thoughts, actions, and temporal nodes.
YggdrasilTokens: Authoritative container for design tokens (colors, fonts, spacing).
ModifiedView: The type produced when a modifier is applied to a View.

Main Modifiers

.bifrost(): Applies frosted glass effects.
.gungnir(): Applies neon glow effects.
.mjolnir_slice(): Applies geometric clipping.
.padding(), .background(), .frame(): Standard layout and styling modifiers.

Usage Example

use cvkg_core::prelude::*;

struct MyComponent;

impl View for MyComponent {
    type Body = impl View;
    
    fn body(self) -> Self::Body {
        Text::new("Skål!")
            .padding(20.0)
            .background([0.1, 0.1, 0.1, 1.0])
            .bifrost(10.0, 1.0, 0.5)
            .gungnir([0.0, 1.0, 1.0, 1.0], 5.0, 1.0)
    }
}

Known Limitations

Modifier order matters; transformations are applied sequentially.
Recursive view bodies will cause a stack overflow at compile time or runtime if not type-erased.

cvkg-core 0.1.22