@dammgo/vena-visual-engine 0.3.0-alpha.1 → 0.3.0-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -13
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,31 +1,31 @@
|
|
|
1
1
|
# VENA Visual Engine 🚀
|
|
2
2
|
|
|
3
|
-
> **"
|
|
3
|
+
> **"Reality-Aware Infrastructure. Engineering as Art."**
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@dammgo/vena-visual-engine)
|
|
6
6
|
[](https://github.com/dammgo/vena-visual-engine/blob/main/LICENSE)
|
|
7
7
|
|
|
8
8
|
## 🧬 The Manifesto
|
|
9
9
|
|
|
10
|
-
The web has been colonized by the generic.
|
|
10
|
+
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.
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
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.
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
16
16
|
## 🏛️ Axioms of the Engine
|
|
17
17
|
|
|
18
|
-
1. **
|
|
19
|
-
2. **
|
|
20
|
-
3. **
|
|
21
|
-
4. **
|
|
18
|
+
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).
|
|
19
|
+
2. **The Reality Categories (VRC):** The engine differentiates between **App**, **Content**, and **Landing** realities, injecting specific mathematical formulas for typography and spacing in each.
|
|
20
|
+
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.
|
|
21
|
+
4. **Precision over Organic:** We reject the "round-everything" culture. Surfaces should feel like precision-cut steel, calibrated for professional hardware.
|
|
22
22
|
|
|
23
23
|
---
|
|
24
24
|
|
|
25
25
|
## 🛠️ Installation
|
|
26
26
|
|
|
27
27
|
```bash
|
|
28
|
-
npm install @dammgo/vena-visual-engine unocss
|
|
28
|
+
npm install @dammgo/vena-visual-engine@alpha unocss
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
## 📡 Quick Start (UnoCSS)
|
|
@@ -43,20 +43,39 @@ export default defineConfig({
|
|
|
43
43
|
protocol: 'erpbsg' // Options: 'erpbsg' | 'dammgo' | 'vena' | 'kode-reboot'
|
|
44
44
|
}),
|
|
45
45
|
],
|
|
46
|
+
content: {
|
|
47
|
+
pipeline: {
|
|
48
|
+
include: [
|
|
49
|
+
'src/**/*.{js,ts,jsx,tsx}',
|
|
50
|
+
'node_modules/@dammgo/vena-visual-engine/dist/**/*.js', // Required for Shortcut resolution
|
|
51
|
+
],
|
|
52
|
+
},
|
|
53
|
+
},
|
|
46
54
|
})
|
|
47
55
|
```
|
|
48
56
|
|
|
49
57
|
---
|
|
50
58
|
|
|
59
|
+
## 🎭 Activating Realities
|
|
60
|
+
|
|
61
|
+
To use the elastic units of VVE, wrap your container with a **Reality Class**:
|
|
62
|
+
|
|
63
|
+
- **`.vve-reality-app`**: Prioritizes height. Ideal for Logins/Dashboards. Everything fits in 600px altitude.
|
|
64
|
+
- **`.vve-reality-content`**: Prioritizes width and readability. Ideal for Documentation/Blogs.
|
|
65
|
+
- **`.vve-reality-landing`**: Prioritizes monumental impact. Ideal for Marketing.
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
51
69
|
## 📚 Documentation
|
|
52
70
|
|
|
53
71
|
Detailed guides for our sovereign syntax:
|
|
54
72
|
|
|
55
|
-
- [**Architecture Blueprint**](./docs/ARCHITECTURE.md):
|
|
56
|
-
- [**
|
|
57
|
-
- [**
|
|
58
|
-
- [**
|
|
73
|
+
- [**Architecture Blueprint**](./docs/ARCHITECTURE.md): The multi-protocol factory and the Elastic Root.
|
|
74
|
+
- [**Reality Manual**](./docs/REALITY_MANUAL.md): How to implement intentions and use VENA Units.
|
|
75
|
+
- [**Technical Specification**](./docs/SPECIFICATION.md): The mathematical formulas behind VRC.
|
|
76
|
+
- [**Protocol Handbook**](./docs/PROTOCOL_HANDBOOK.md): Registering and building new brand identities.
|
|
77
|
+
- [**Changelog**](./docs/CHANGELOG.md): Tracking the visual revolution.
|
|
59
78
|
|
|
60
79
|
---
|
|
61
|
-
**dammgo labs** - _Engineering
|
|
80
|
+
**dammgo labs** - _Engineering Reality._
|
|
62
81
|
© 2026. Distributed under the MIT License.
|
package/package.json
CHANGED