@dammgo/vena-visual-engine 0.3.0-alpha.1 → 0.3.0-alpha.3

package/README.md

@@ -1,31 +1,31 @@
 # VENA Visual Engine 🚀
 
-> **"Engineering as Art. Sovereignty as Standard."**
+> **"Reality-Aware Infrastructure. Engineering as Art."**
 
 [![Version](https://img.shields.io/npm/v/@dammgo/vena-visual-engine?color=E91E63&label=VVE)](https://www.npmjs.com/package/@dammgo/vena-visual-engine)
 [![License](https://img.shields.io/npm/l/@dammgo/vena-visual-engine?color=00d4ff)](https://github.com/dammgo/vena-visual-engine/blob/main/LICENSE)
 
 ## 🧬 The Manifesto
 
-The web has been colonized by the generic. AI-generated interfaces have commoditized "good taste," filling our screens with predictable shadows, rounded corners, and a lack of character. 
+The web has been colonized by the generic. **VENA Visual Engine (VVE)** is a rebellion. It is not another CSS framework for "friendly" apps. It is a **Sovereign Infrastructure** for building digital interfaces that reflect precision, authority, and longevity. 
 
-**VENA Visual Engine (VVE)** is a rebellion. It is not another CSS framework for "friendly" apps. It is a **Sovereign Infrastructure** for building digital interfaces that reflect precision, authority, and longevity. We don't build "UI components"; we build **Visual Protocols**.
+Starting from **v0.3.0**, VVE evolves from a static preset to a **Reality-Aware Engine** that understands the observer's environment and the developer's intention.
 
 ---
 
 ## 🏛️ Axioms of the Engine
 
-1.  **Precision over Organic:** We reject the "round-everything" culture. Surfaces should feel like precision-cut steel.
-2.  **Hardware Awareness:** Altitude-conscious design. We optimize for the screen where the work happens (Laptops), not just the desk where we design (2K/4K).
-3.  **Context Sovereignty:** The engine differentiates between Application, Landing, and Laboratory realities, injecting specific infrastructure resets for each.
-4.  **The Active Pulse:** Interfaces are live signals. We treat the rendering process as a vital pulse of data.
+1.  **Holistic Responsiveness:** We don't just look at width. We look at **Intention** and **Altitude**. Components shrink and expand based on the total available surface area (Width + Height).
+2.  **The Reality Categories (VRC):** The engine differentiates between **App**, **Content**, and **Landing** realities, injecting specific mathematical formulas for typography and spacing in each.
+3.  **Layout Sovereignty:** VVE provides the **DNA (The Skin)**, but the **Page owns the Skeleton**. Structural positioning (Flex, Grid, Height) remains local to ensure perfect compiler visibility and flexibility.
+4.  **Precision over Organic:** We reject the "round-everything" culture. Surfaces should feel like precision-cut steel, calibrated for professional hardware.
 
 ---
 
 ## 🛠️ Installation
 
 ```bash
-npm install @dammgo/vena-visual-engine unocss
+npm install @dammgo/vena-visual-engine@alpha unocss
 ```
 
 ## 📡 Quick Start (UnoCSS)
@@ -43,20 +43,39 @@ export default defineConfig({
       protocol: 'erpbsg' // Options: 'erpbsg' | 'dammgo' | 'vena' | 'kode-reboot'
     }),
   ],
+  content: {
+    pipeline: {
+      include: [
+        'src/**/*.{js,ts,jsx,tsx}',
+        'node_modules/@dammgo/vena-visual-engine/dist/**/*.js', // Required for Shortcut resolution
+      ],
+    },
+  },
 })
 ```
 
 ---
 
+## 🎭 Activating Realities
+
+To use the elastic units of VVE, wrap your container with a **Reality Class**:
+
+- **`.vve-reality-app`**: Prioritizes height. Ideal for Logins/Dashboards. Everything fits in 600px altitude.
+- **`.vve-reality-content`**: Prioritizes width and readability. Ideal for Documentation/Blogs.
+- **`.vve-reality-landing`**: Prioritizes monumental impact. Ideal for Marketing.
+
+---
+
 ## 📚 Documentation
 
 Detailed guides for our sovereign syntax:
 
-- [**Architecture Blueprint**](./docs/ARCHITECTURE.md): Understand the factory and the DNA injection.
-- [**VVE Specification**](./docs/VVE_SPECIFICATION.md): The three realities (App, Landing, Blog).
-- [**Protocol Handbook**](./docs/PROTOCOL_HANDBOOK.md): How to register and build a new visual identity.
-- [**Visual Philosophy**](./docs/PHILOSOPHY.md): The ergonomic and aesthetic ethics of the engine.
+- [**Architecture Blueprint**](./docs/ARCHITECTURE.md): The multi-protocol factory and the Elastic Root.
+- [**Reality Manual**](./docs/REALITY_MANUAL.md): How to implement intentions and use VENA Units.
+- [**Technical Specification**](./docs/SPECIFICATION.md): The mathematical formulas behind VRC.
+- [**Protocol Handbook**](./docs/PROTOCOL_HANDBOOK.md): Registering and building new brand identities.
+- [**Changelog**](./docs/CHANGELOG.md): Tracking the visual revolution.
 
 ---
-**dammgo labs** - _Engineering Longevity._
+**dammgo labs** - _Engineering Reality._
 © 2026. Distributed under the MIT License.

package/dist/core/index.d.ts

@@ -4,6 +4,9 @@
  */
 export declare const coreTheme: {
     colors: {
+        void: string;
+        cobalt: string;
+        armor: string;
         bos: {
             slate: string;
             pink: string;

package/dist/core/index.js

@@ -5,6 +5,11 @@ import { presetUno, presetWebFonts } from 'unocss';
  */
 export const coreTheme = {
     colors: {
+        // --- SOVEREIGN TOKENS (Direct Access) ---
+        void: '#030712', // Negro abisal (Sovereign Base)
+        cobalt: '#00d4ff', // VENA Intelligence (Cyan Electric)
+        armor: '#1e293b', // Gris blindaje (Border/Infrastructure)
+        // --- LEGACY NAMESPACE (BOS) ---
         bos: {
             slate: '#020617',
             pink: '#E91E63',
@@ -44,6 +49,9 @@ export const coreShortcuts = [
     ['precision-bracket', 'relative before:content-[""] before:absolute before:-top-1 before:-left-1 before:w-2 before:h-2 before:border-t-1 before:border-l-1 before:border-bos-pink after:content-[""] after:absolute after:-bottom-1 after:-right-1 after:w-2 after:h-2 after:border-b-1 after:border-r-1 after:border-bos-pink'],
     ['infra-grid', 'relative before:content-[""] before:absolute before:inset-0 before:opacity-0 before:pointer-events-none before:[background-image:radial-gradient(#f8fafc_1px,transparent_1px)] before:[background-size:10px_10px] focus-within:before:opacity-10 before:transition-opacity'],
     ['synapse-line', 'h-1 bg-white/5 relative overflow-hidden after:content-[""] after:absolute after:inset-0 after:bg-gradient-to-r after:from-transparent after:via-bos-pink after:to-transparent after:animate-pulse'],
+    // --- CINEMATIC SHORCUTS ---
+    ['glass-armor', 'backdrop-blur-md bg-void/10 border border-armor/20'],
+    ['text-glow', 'drop-shadow-[0_0_10px_currentColor]'],
 ];
 /**
  * Reality Category Preflights (The Elastic Root)

package/dist/protocols/vena.js

@@ -1,7 +1,16 @@
 export const venaShortcuts = [
     // --- IDENTIDAD DE INTELIGENCIA (ATÓMICA) ---
-    ['vena-monitor', 'bg-black border-[0.5px] border-bos-cobalt/20 font-mono text-[11px] text-bos-cobalt/80'],
-    ['vena-pulse-line', 'h-[1px] bg-bos-cobalt/10 relative overflow-hidden after:content-[""] after:absolute after:inset-0 after:bg-bos-cobalt after:animate-scan'],
+    ['vena-monitor', 'bg-black border-[0.5px] border-cobalt/20 font-mono text-[11px] text-cobalt/80'],
+    ['vena-pulse-line', 'h-[1px] bg-cobalt/10 relative overflow-hidden after:content-[""] after:absolute after:inset-0 after:bg-cobalt after:animate-scan'],
+    // --- ESTRUCTURAS CINEMÁTICAS (Soberanía Visual) ---
+    ['vena-glass-armor', 'glass-armor'],
+    ['vena-text-glow', 'text-glow'],
+    // --- PROTOCOLOS DE CAPTURA (Ingeniería de Precisión) ---
+    // El input cinemático de VENA: Fondo abisal, texto blanco y brackets de cobalto al enfocar.
+    ['vena-input', 'bg-void border border-armor/50 px-4 py-3 font-mono text-sm text-white placeholder:text-armor/50 outline-none transition-all focus:border-cobalt/50 relative before:content-[""] before:absolute before:-top-1 before:-left-1 before:w-2 before:h-2 before:border-t-1 before:border-l-1 before:border-cobalt before:opacity-0 focus:before:opacity-100 after:content-[""] after:absolute after:-bottom-1 after:-right-1 after:w-2 after:h-2 after:border-b-1 after:border-r-1 after:border-cobalt after:opacity-0 focus:after:opacity-100'],
+    // --- ACCIONES SOBERANAS (Contraste Máximo) ---
+    // El botón de vanguardia: Cobalto con texto abisal. Invierte en hover.
+    ['vena-btn-primary', 'bg-cobalt text-void font-black uppercase tracking-[0.2em] text-[10px] px-8 py-4 hover:bg-white hover:text-void transition-all duration-500 shadow-[0_0_15px_rgba(0,212,255,0.3)] shadow-glow disabled:opacity-50 disabled:cursor-not-allowed'],
 ];
 export const venaRules = [
     ['animate-scan', { animation: 'scan 2s linear infinite' }],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dammgo/vena-visual-engine",
-  "version": "0.3.0-alpha.1",
+  "version": "0.3.0-alpha.3",
   "description": "The Sovereign Visual Engine. Reality-Aware Infrastructure for the erpbsg ecosystem.",
   "type": "module",
   "main": "./dist/index.js",