@m00rl0ck/simple-builder 1.1.3 → 1.1.5

package/README.md

@@ -0,0 +1,193 @@
+# ⚡ Simple Builder
+
+> Zero-dependency JavaScript та CSS збирач (bundler) з dev сервером та мініфікацією.
+
+---
+
+## 🚀 Можливості
+
+- **Нуль залежностей** — встановив і працює
+- **ES Modules** — імпорти, експорти, дерево залежностей
+- **Бандлінг** — збирає всі JS файли в один
+- **CSS** — автоматично копіює та мініфікує CSS
+- **HTML** — автоматично підставляє зібрані файли
+- **Dev сервер** — вбудований HTTP сервер з **live reload**
+- **Watch mode** — автоматична перезбірка при зміні файлів
+- **Мініфікація JS та CSS** — для production збірки
+
+---
+
+## 📦 Встановлення
+
+```bash
+npm install @m00rl0ck/simple-builder
+```
+
+---
+
+## 🖥 CLI (Командний рядок)
+
+Після встановлення доступна команда `simple-builder`:
+
+```bash
+# Збірка проекту (development)
+simple-builder build
+
+# Розробка з автоперезбіркою (watch mode)
+simple-builder dev
+
+# Запуск dev сервера (http://localhost:3000) + watch + live reload
+simple-builder serve
+
+# Запуск production сервера
+simple-builder serve prod
+```
+
+### Використання в `package.json`
+
+```json
+{
+  "scripts": {
+    "build": "simple-builder build",
+    "dev": "simple-builder dev",
+    "serve": "simple-builder serve",
+    "prod": "simple-builder serve prod"
+  }
+}
+```
+
+Комбінації аргументів працюють у будь-якому порядку:
+
+```bash
+simple-builder serve prod
+simple-builder prod serve
+```
+
+---
+
+## 📦 Використання як API
+
+```js
+import { build, runServer } from '@m00rl0ck/simple-builder';
+
+// Збірка (development)
+build();
+
+// Збірка (production)
+build({ isProd: true });
+
+// Watch mode
+build({ watch: true });
+
+// Dev сервер (development — з watch + live reload)
+runServer();
+
+// Dev сервер (production)
+runServer({ isProd: true });
+```
+
+---
+
+## 🏗 Як це працює
+
+```
+src/
+├── index.js        — точка входу (або вказана в env.js)
+├── index.html      — HTML шаблон
+└── *.css           — CSS файли
+
+dist/               — створюється автоматично
+├── bundle.min.js   — зібраний JS
+├── index.html      — HTML з підставленими шляхами
+└── *.css / *.min.css
+```
+
+**Правила:**
+- Точка входу — `src/index.js`. Або вкажіть у `env.js`: `IN_POINT = "app"` → буде `src/app.js`.
+- HTML береться з `src/index.html`.
+- CSS файли обробляються окремо і кладуться в `dist/`.
+- У production режимі JS мініфікується (`bundle.min.js`), CSS отримує суфікс `.min.css`.
+- Dev сервер має **live reload** — будь-яка зміна в `src/` перезавантажує сторінку.
+
+---
+
+## 📄 Ліцензія
+
+MIT — робіть що хочете.
+
+---
+
+## 💬 Чому?
+
+Мінімалістичний бандлер без магії. Жодних прихованих залежностей, складних конфігів та багатотонних `node_modules`. Просто бандлінг, який ти розумієш.
+
+---
+
+## English
+
+# ⚡ Simple Builder
+
+> Zero-dependency JS and CSS bundler with dev server and minifier.
+
+## Features
+
+- **Zero dependencies** — install and go
+- **ES Modules** — imports, exports, dependency tree
+- **Bundling** — combines all JS files into one
+- **CSS** — automatically copies and minifies CSS
+- **HTML** — automatically injects bundled files
+- **Dev server** — built-in HTTP server with **live reload**
+- **Watch mode** — automatic rebuild on file changes
+- **JS & CSS minification** — for production builds
+
+## Install
+
+```bash
+npm install @m00rl0ck/simple-builder
+```
+
+## CLI
+
+```bash
+# Build project (development)
+simple-builder build
+
+# Development with auto-rebuild (watch mode)
+simple-builder dev
+
+# Start dev server (http://localhost:3000) + watch + live reload
+simple-builder serve
+
+# Start production server
+simple-builder serve prod
+```
+
+### Use in `package.json`
+
+```json
+{
+  "scripts": {
+    "build": "simple-builder build",
+    "dev": "simple-builder dev",
+    "serve": "simple-builder serve",
+    "prod": "simple-builder serve prod"
+  }
+}
+```
+
+## API
+
+```js
+import { build, runServer } from '@m00rl0ck/simple-builder';
+
+build();                    // development build
+build({ isProd: true });    // production build
+build({ watch: true });     // watch mode
+
+runServer();                // dev server (development, watch + live reload)
+runServer({ isProd: true });// dev server (production mode)
+```
+
+## License
+
+MIT — do whatever you want.

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@m00rl0ck/simple-builder",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Zero-dependency JS and CSS bundler with dev server and minifier",
   "changelog": {
     "1.1.1": "Fix: small bugs",
     "1.1.2": "Fix: ternary console.log",
-    "1.1.3": "Fix: crash on build() without args, unused vars, hardcoded entry, watchBuild initial build, default imports support"
+    "1.1.3": "Fix: crash on build() without args, unused vars, hardcoded entry, watchBuild initial build, default imports support",
+    "1.1.5": "Feat: add readme"
   },
   "type": "module",
   "main": "index.js",