vanduo-framework 1.1.8 → 1.2.1
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 +42 -31
- package/dist/build-info.json +3 -3
- package/dist/vanduo.cjs.js +720 -111
- package/dist/vanduo.cjs.js.map +3 -3
- package/dist/vanduo.cjs.min.js +11 -11
- package/dist/vanduo.cjs.min.js.map +4 -4
- package/dist/vanduo.css +285 -1
- package/dist/vanduo.css.map +1 -1
- package/dist/vanduo.esm.js +720 -111
- package/dist/vanduo.esm.js.map +3 -3
- package/dist/vanduo.esm.min.js +11 -11
- package/dist/vanduo.esm.min.js.map +4 -4
- package/dist/vanduo.js +720 -111
- package/dist/vanduo.js.map +3 -3
- package/dist/vanduo.min.css +1 -1
- package/dist/vanduo.min.js +11 -11
- package/dist/vanduo.min.js.map +4 -4
- package/js/components/code-snippet.js +5 -3
- package/js/components/doc-search.js +90 -73
- package/js/components/grid.js +22 -22
- package/js/components/lazy-load.js +353 -0
- package/js/components/theme-customizer.js +20 -4
- package/js/components/tooltips.js +1 -1
- package/js/index.js +1 -0
- package/js/utils/helpers.js +24 -12
- package/js/vanduo.js +14 -14
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,4 +1,15 @@
|
|
|
1
|
-
# Vanduo Framework v1.
|
|
1
|
+
# Vanduo Framework v1.2.0
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<img src="vanduo-banner.svg" alt="Vanduo Framework Banner" width="100%">
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<a href="https://www.npmjs.com/package/vanduo-framework"><img src="https://img.shields.io/npm/v/vanduo-framework?style=flat-square&color=3b82f6" alt="NPM Version"></a>
|
|
9
|
+
<a href="https://github.com/Nostromo-618/vanduo-framework/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/Nostromo-618/vanduo-framework/ci.yml?branch=main&style=flat-square&color=10b981" alt="Build Status"></a>
|
|
10
|
+
<a href="https://github.com/Nostromo-618/vanduo-framework/blob/main/dist/vanduo.min.css"><img src="https://img.shields.io/badge/minified_size-~110kb-8b5cf6?style=flat-square" alt="Minified Size"></a>
|
|
11
|
+
<a href="https://github.com/Nostromo-618/vanduo-framework/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Nostromo-618/vanduo-framework?style=flat-square&color=64748b" alt="License"></a>
|
|
12
|
+
</p>
|
|
2
13
|
|
|
3
14
|
**Essential just like water is.**
|
|
4
15
|
|
|
@@ -8,7 +19,7 @@
|
|
|
8
19
|
|
|
9
20
|
## Overview
|
|
10
21
|
|
|
11
|
-
A lightweight, pure HTML/CSS/JS framework for designing beautiful
|
|
22
|
+
A lightweight, pure HTML/CSS/JS framework for designing beautiful interfaces. Zero runtime dependencies, no mandatory build tools, just clean and simple code.
|
|
12
23
|
|
|
13
24
|
[**Browse Full Documentation →**]([https://vanduo.dev/#docs](https://vanduo.dev/#docs)
|
|
14
25
|
|
|
@@ -24,11 +35,34 @@ A lightweight, pure HTML/CSS/JS framework for designing beautiful static website
|
|
|
24
35
|
- 🎛️ **Theme Customizer** - Real-time color, radius, font, and mode customization
|
|
25
36
|
- 🔍 **SEO-Ready** - Comprehensive meta tags, structured data, and sitemap
|
|
26
37
|
|
|
38
|
+
### The Vanduo Way
|
|
39
|
+
Stop wrapping everything in bloated container DOMs. Build beautiful, accessible UI components with clean, predictable utility classes:
|
|
40
|
+
|
|
41
|
+
```html
|
|
42
|
+
<!-- Raw HTML -->
|
|
43
|
+
<button>Click Me</button>
|
|
44
|
+
|
|
45
|
+
<!-- With Vanduo Framework -->
|
|
46
|
+
<button class="vd-btn vd-btn-primary vd-radius-full">
|
|
47
|
+
<i class="ph ph-sparkle"></i> Click Me
|
|
48
|
+
</button>
|
|
49
|
+
```
|
|
50
|
+
|
|
27
51
|
---
|
|
28
52
|
|
|
29
53
|
## Quick Start
|
|
30
54
|
|
|
31
|
-
### Option 1:
|
|
55
|
+
### Option 1: Package Manager (Recommended)
|
|
56
|
+
|
|
57
|
+
**We strongly recommend using [pnpm](https://pnpm.io/)** for installing Vanduo Framework. Vanduo is strictly configured with `.npmrc` security policies (such as blocking exotic sub-dependencies and strict peer enforcement) that work best with inside the pnpm ecosystem.
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
pnpm add vanduo-framework
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
*(Note: While `npm install vanduo-framework` and `yarn add vanduo-framework` will still technically work, they do not inherently enforce the same strict lockfile and isolated `node_modules` security guarantees that pnpm provides out-of-the-box).*
|
|
64
|
+
|
|
65
|
+
### Option 2: CDN (Fastest)
|
|
32
66
|
|
|
33
67
|
Load directly from jsDelivr — no download required:
|
|
34
68
|
|
|
@@ -54,36 +88,13 @@ Load directly from jsDelivr — no download required:
|
|
|
54
88
|
|
|
55
89
|
**Pin to a specific version** (recommended for production):
|
|
56
90
|
```html
|
|
57
|
-
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/Nostromo-618/vanduo-framework@v1.
|
|
58
|
-
<script src="https://cdn.jsdelivr.net/gh/Nostromo-618/vanduo-framework@v1.
|
|
91
|
+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/Nostromo-618/vanduo-framework@v1.2.0/dist/vanduo.min.css">
|
|
92
|
+
<script src="https://cdn.jsdelivr.net/gh/Nostromo-618/vanduo-framework@v1.2.0/dist/vanduo.min.js"></script>
|
|
59
93
|
<script>Vanduo.init();</script>
|
|
60
94
|
```
|
|
61
95
|
|
|
62
|
-
### ⚠️ Breaking Changes in v1.1.0
|
|
63
|
-
|
|
64
|
-
**CSS Class Prefixing:** All CSS classes now use the `vd-` prefix to prevent collisions with other frameworks:
|
|
65
|
-
- `.btn` → `.vd-btn`
|
|
66
|
-
- `.container` → `.vd-container`
|
|
67
|
-
- `.card` → `.vd-card`
|
|
68
|
-
- etc.
|
|
69
|
-
|
|
70
|
-
**Manual Initialization:** Framework no longer auto-initializes. Explicitly call `Vanduo.init()` after loading:
|
|
71
|
-
```html
|
|
72
|
-
<script src="dist/vanduo.min.js"></script>
|
|
73
|
-
<script>Vanduo.init();</script>
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
For dynamic DOM updates (SPAs), run cleanup before re-init:
|
|
77
|
-
```html
|
|
78
|
-
<script>
|
|
79
|
-
Vanduo.destroyAll();
|
|
80
|
-
Vanduo.init();
|
|
81
|
-
</script>
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
See [MIGRATION.md](MIGRATION.md) for complete upgrade guide.
|
|
85
96
|
|
|
86
|
-
### Option
|
|
97
|
+
### Option 3: Download
|
|
87
98
|
|
|
88
99
|
[**Download dist/ folder**](https://github.com/Nostromo-618/vanduo-framework/tree/main/dist) and include locally:
|
|
89
100
|
|
|
@@ -107,7 +118,7 @@ See [MIGRATION.md](MIGRATION.md) for complete upgrade guide.
|
|
|
107
118
|
|
|
108
119
|
The `dist/` folder is **self-contained** (CSS, JS, Fonts, Icons).
|
|
109
120
|
|
|
110
|
-
### Option
|
|
121
|
+
### Option 4: Source Files
|
|
111
122
|
|
|
112
123
|
For development or when you need more control, use the unminified source:
|
|
113
124
|
|
|
@@ -142,7 +153,7 @@ This project includes an [`llms.txt`](llms.txt) file — a structured markdown s
|
|
|
142
153
|
Use the hardened upload script to attach only approved bundle artifacts from `dist/`:
|
|
143
154
|
|
|
144
155
|
```bash
|
|
145
|
-
pnpm run release:assets -- v1.
|
|
156
|
+
pnpm run release:assets -- v1.2.0
|
|
146
157
|
```
|
|
147
158
|
|
|
148
159
|
Notes:
|
package/dist/build-info.json
CHANGED