# Hybrid UI & Layout Engine

To achieve excellent performance optimization while supporting rich interface interactions, **Asterisk 2** implements a decoupled, hybrid layout processing pipeline. The interface engine physically separates structural dashboard operations from ultra-fast public content acquisition interfaces.

---

## Dual Presentation Layers

The platform maintains two separate UI master templates rendered via native Razor processing engine components:

```mermaid
graph LR
    %% Request Router
    subgraph Browser["User Browser Access"]
        Req["Incoming View Request"]
    end

    %% Engine Dispatch
    subgraph LayoutEngine["Razor Layout Processing Matrix"]
        Layout_App["_Layout.cshtml<br/>(High-Density Application Mode)"]
        Layout_Mkt["_MarketingLayout.cshtml<br/>(High-Speed Acquisition Mode)"]
    end

    %% Components
    subgraph InterfaceTier["Target DOM Integration"]
        DOM_Dash["Persistent Confluence-Style Sidebars<br/>& Native Data-Grid Frameworks"]
        DOM_Read["Pre-Rendered Static DOM<br/>Optimized for TTFB & Core Web Vitals"]
    end

    %% Routes
    Req -->|"Authenticated Access<br/>(/Admin, /Agent)"| Layout_App
    Req -->|"Unauthenticated / Public<br/>(/Docs, /Landing)"| Layout_Mkt
    
    Layout_App ==>|"Dynamic DOM Inject"| DOM_Dash
    Layout_Mkt ==>|"Pure CDN Delivery"| DOM_Read

    %% Styling
    classDef layoutToken fill:#0f172a,stroke:#38bdf8,stroke-width:2px,color:#fff,rx:6px,ry:6px;
    classDef domToken fill:#1e293b,stroke:#a855f7,stroke-width:2px,color:#fff,rx:6px,ry:6px;

    class Layout_App,Layout_Mkt layoutToken;
    class DOM_Dash,DOM_Read domToken;
```

---

## Technical Layout Matrix

### 1. Application Dashboard Core (`_Layout.cshtml`)
Engineered for intense interactive usage, state management, and dense authoring:
- **Persistent Spatial Sidebars**: Left-hand structural navigation containers are locked to a defined column layout to completely eliminate visual jitter or unwanted document overflow.
- **Dynamic Asset Context**: Embeds real-time client configurations (`mcp_config.json` generators) directly into authenticated workspace instances.
- **Visual Stability Components**: Includes dedicated focus controllers preventing visual distortion or overlapping elements during text selection and document RAG processing.

### 2. Marketing Presentation Hub (`_MarketingLayout.cshtml`)
Optimized for maximum speed, public documentation parsing, and zero layout shifting:
- **Ultra-Low Initial TTFB**: Completely purges heavy application scripts, state tracking modules, and interactive client bundles from the head segment.
- **CSS-Native Readability**: Employs highly optimized, vanilla styling tokens rendering crisp text blocks and aligned media directly from pre-chunked markdown databases.
- **SEO & Core Web Vitals**: Guarantees single-pass layout calculation for search engine robots mapping out documentation networks globally.

---

## Presentation Integrity
All pages rendered under both engine matrices automatically adhere to strict presentation criteria ensuring clean margins, accessible contrast ratios, and flawless rendering of embedded native markdown visual assets.