@m00rl0ck/simple-builder 1.1.4 → 1.1.5

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.
Files changed (2) hide show
  1. package/README.md +130 -78
  2. package/package.json +3 -2
package/README.md CHANGED
@@ -1,141 +1,193 @@
1
1
  # ⚡ Simple Builder
2
2
 
3
- > Zero-deps JavaScript bundler. Fast, minimal, under your control.
3
+ > Zero-dependency JavaScript та CSS збирач (bundler) з dev сервером та мініфікацією.
4
4
 
5
5
  ---
6
6
 
7
- ## 🤔 Why?
7
+ ## 🚀 Можливості
8
8
 
9
- Modern tools like Webpack and Vite are powerful… but often **overkill**.
9
+ - **Нуль залежностей** — встановив і працює
10
+ - **ES Modules** — імпорти, експорти, дерево залежностей
11
+ - **Бандлінг** — збирає всі JS файли в один
12
+ - **CSS** — автоматично копіює та мініфікує CSS
13
+ - **HTML** — автоматично підставляє зібрані файли
14
+ - **Dev сервер** — вбудований HTTP сервер з **live reload**
15
+ - **Watch mode** — автоматична перезбірка при зміні файлів
16
+ - **Мініфікація JS та CSS** — для production збірки
10
17
 
11
- * Too many dependencies
12
- * Hard to understand what’s going on
13
- * Configs become a mess
18
+ ---
14
19
 
15
- **Simple Builder** exists for one reason:
20
+ ## 📦 Встановлення
16
21
 
17
- > Give you a bundler you actually understand.
22
+ ```bash
23
+ npm install @m00rl0ck/simple-builder
24
+ ```
18
25
 
19
26
  ---
20
27
 
21
- ## 🚀 Features
28
+ ## 🖥 CLI (Командний рядок)
22
29
 
23
- * ⚡ Zero dependencies
24
- * 📦 ES Modules support
25
- * 🔥 Super fast builds
26
- * 🧠 Simple and predictable behavior
27
- * 🪶 Lightweight (no bloat)
30
+ Після встановлення доступна команда `simple-builder`:
28
31
 
29
- ---
32
+ ```bash
33
+ # Збірка проекту (development)
34
+ simple-builder build
30
35
 
31
- ## 📦 Installation
36
+ # Розробка з автоперезбіркою (watch mode)
37
+ simple-builder dev
32
38
 
33
- ```bash
34
- npm install simple-builder
39
+ # Запуск dev сервера (http://localhost:3000) + watch + live reload
40
+ simple-builder serve
41
+
42
+ # Запуск production сервера
43
+ simple-builder serve prod
35
44
  ```
36
45
 
37
- ---
46
+ ### Використання в `package.json`
47
+
48
+ ```json
49
+ {
50
+ "scripts": {
51
+ "build": "simple-builder build",
52
+ "dev": "simple-builder dev",
53
+ "serve": "simple-builder serve",
54
+ "prod": "simple-builder serve prod"
55
+ }
56
+ }
57
+ ```
38
58
 
39
- ## ⚙️ Usage
59
+ Комбінації аргументів працюють у будь-якому порядку:
40
60
 
41
61
  ```bash
42
- simple-builder build
62
+ simple-builder serve prod
63
+ simple-builder prod serve
43
64
  ```
44
65
 
45
- Or with config:
66
+ ---
67
+
68
+ ## 📦 Використання як API
46
69
 
47
70
  ```js
48
- import { build } from 'simple-builder';
71
+ import { build, runServer } from '@m00rl0ck/simple-builder';
49
72
 
50
- build({
51
- entry: './src/app.js',
52
- output: './dist/bundle.js'
53
- });
54
- ```
73
+ // Збірка (development)
74
+ build();
55
75
 
56
- ---
76
+ // Збірка (production)
77
+ build({ isProd: true });
57
78
 
58
- ## 🧩 Example
79
+ // Watch mode
80
+ build({ watch: true });
59
81
 
60
- ```js
61
- // app.js
62
- import { hello } from './hello.js';
82
+ // Dev сервер (development — з watch + live reload)
83
+ runServer();
63
84
 
64
- hello();
85
+ // Dev сервер (production)
86
+ runServer({ isProd: true });
65
87
  ```
66
88
 
67
- 👉 Run build → get a single bundled file.
68
-
69
89
  ---
70
90
 
71
- ## 😎 Why choose Simple Builder?
91
+ ## 🏗 Як це працює
72
92
 
73
- | Feature | Simple Builder | Webpack | Vite |
74
- | ------------------ | -------------- | ------- | ---- |
75
- | Zero deps | ✅ | ❌ | ❌ |
76
- | Easy to understand | ✅ | ❌ | ⚠️ |
77
- | Minimal config | ✅ | ❌ | ✅ |
78
- | Full control | ✅ | ⚠️ | ⚠️ |
93
+ ```
94
+ src/
95
+ ├── index.js — точка входу (або вказана в env.js)
96
+ ├── index.html — HTML шаблон
97
+ └── *.css — CSS файли
98
+
99
+ dist/ — створюється автоматично
100
+ ├── bundle.min.js — зібраний JS
101
+ ├── index.html — HTML з підставленими шляхами
102
+ └── *.css / *.min.css
103
+ ```
104
+
105
+ **Правила:**
106
+ - Точка входу — `src/index.js`. Або вкажіть у `env.js`: `IN_POINT = "app"` → буде `src/app.js`.
107
+ - HTML береться з `src/index.html`.
108
+ - CSS файли обробляються окремо і кладуться в `dist/`.
109
+ - У production режимі JS мініфікується (`bundle.min.js`), CSS отримує суфікс `.min.css`.
110
+ - Dev сервер має **live reload** — будь-яка зміна в `src/` перезавантажує сторінку.
79
111
 
80
112
  ---
81
113
 
82
- ## 💡 Philosophy
114
+ ## 📄 Ліцензія
83
115
 
84
- * No magic
85
- * No hidden behavior
86
- * Just JavaScript
116
+ MIT — робіть що хочете.
87
117
 
88
118
  ---
89
119
 
90
- ## 🔥 Pro Version
120
+ ## 💬 Чому?
91
121
 
92
- Want more power?
122
+ Мінімалістичний бандлер без магії. Жодних прихованих залежностей, складних конфігів та багатотонних `node_modules`. Просто бандлінг, який ти розумієш.
93
123
 
94
- ### 👉 Simple Builder Pro includes:
124
+ ---
95
125
 
96
- * 👀 Watch mode
97
- * ⚡ Advanced caching
98
- * 🔌 Plugin system
99
- * 🗜 Built-in minifier
100
- * 🚀 Production optimizations
126
+ ## English
101
127
 
102
- ---
128
+ # ⚡ Simple Builder
103
129
 
104
- ## 💳 Get Pro
130
+ > Zero-dependency JS and CSS bundler with dev server and minifier.
105
131
 
106
- Unlock all features and speed up your workflow:
132
+ ## Features
107
133
 
108
- 👉 Get access to Pro version
134
+ - **Zero dependencies** — install and go
135
+ - **ES Modules** — imports, exports, dependency tree
136
+ - **Bundling** — combines all JS files into one
137
+ - **CSS** — automatically copies and minifies CSS
138
+ - **HTML** — automatically injects bundled files
139
+ - **Dev server** — built-in HTTP server with **live reload**
140
+ - **Watch mode** — automatic rebuild on file changes
141
+ - **JS & CSS minification** — for production builds
109
142
 
110
- (coming soon)
143
+ ## Install
111
144
 
112
- ---
145
+ ```bash
146
+ npm install @m00rl0ck/simple-builder
147
+ ```
113
148
 
114
- ## 🛣 Roadmap
149
+ ## CLI
115
150
 
116
- * [ ] Watch mode
117
- * [ ] Plugin API
118
- * [ ] Minifier
119
- * [ ] Dev server improvements
151
+ ```bash
152
+ # Build project (development)
153
+ simple-builder build
120
154
 
121
- ---
155
+ # Development with auto-rebuild (watch mode)
156
+ simple-builder dev
122
157
 
123
- ## 🤝 Contributing
158
+ # Start dev server (http://localhost:3000) + watch + live reload
159
+ simple-builder serve
124
160
 
125
- PRs are welcome. Keep it simple.
161
+ # Start production server
162
+ simple-builder serve prod
163
+ ```
126
164
 
127
- ---
165
+ ### Use in `package.json`
166
+
167
+ ```json
168
+ {
169
+ "scripts": {
170
+ "build": "simple-builder build",
171
+ "dev": "simple-builder dev",
172
+ "serve": "simple-builder serve",
173
+ "prod": "simple-builder serve prod"
174
+ }
175
+ }
176
+ ```
128
177
 
129
- ## ⭐ Support
178
+ ## API
130
179
 
131
- If you like this project:
180
+ ```js
181
+ import { build, runServer } from '@m00rl0ck/simple-builder';
132
182
 
133
- * Star the repo
134
- * Share it
135
- * Use it in your projects
183
+ build(); // development build
184
+ build({ isProd: true }); // production build
185
+ build({ watch: true }); // watch mode
136
186
 
137
- ---
187
+ runServer(); // dev server (development, watch + live reload)
188
+ runServer({ isProd: true });// dev server (production mode)
189
+ ```
138
190
 
139
- ## 🧠 Final thought
191
+ ## License
140
192
 
141
- > Tools should work for you, not the other way around.
193
+ MIT — do whatever you want.
package/package.json CHANGED
@@ -1,11 +1,12 @@
1
1
  {
2
2
  "name": "@m00rl0ck/simple-builder",
3
- "version": "1.1.4",
3
+ "version": "1.1.5",
4
4
  "description": "Zero-dependency JS and CSS bundler with dev server and minifier",
5
5
  "changelog": {
6
6
  "1.1.1": "Fix: small bugs",
7
7
  "1.1.2": "Fix: ternary console.log",
8
- "1.1.3": "Fix: crash on build() without args, unused vars, hardcoded entry, watchBuild initial build, default imports support"
8
+ "1.1.3": "Fix: crash on build() without args, unused vars, hardcoded entry, watchBuild initial build, default imports support",
9
+ "1.1.5": "Feat: add readme"
9
10
  },
10
11
  "type": "module",
11
12
  "main": "index.js",