jspackr 0.3.0 → 0.4.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Kaloka Radia Nanda
+Copyright (c) 2026 Kaloka Radia Nanda
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/README.md

@@ -1,491 +1,120 @@
-<div align="center">
-  <img src="./logo.svg" width="240" alt="packrat (jspackr logo)" />
-</div>
+# jspackr
 
-<h1 align="center">jspackr 0.3.0</h1>
+<img src='./logo.svg' width=150>
 
-<p align="center">
-  A simple, fast, and modern JavaScript bundler powered by esbuild.<br />
-  Lightweight, easy to use, and perfect for small to medium projects.
-</p>
+`jspackr` is a small JavaScript bundler CLI implemented in Go and powered by [esbuild](https://esbuild.github.io/). It bundles one entry file and can minify output, generate source maps, print a size report, and rebuild when files under the entry file's directory change.
 
-<p align="center">
-  <a href="#-installation">Installation</a> •
-  <a href="#-quick-start">Quick Start</a> •
-  <a href="#-usage">Usage</a> •
-  <a href="#-configuration-file">Configuration</a> •
-  <a href="#-examples">Examples</a>
-</p>
+## Features
 
----
+- Bundle JavaScript with esbuild into ESM, IIFE, or CommonJS output.
+- ESM output supports top-level `await`.
+- Optional whitespace, syntax, and identifier minification.
+- Linked or inline source maps.
+- Build size report and watch mode.
+- JSON configuration plus command line overrides.
 
-## ✨ Features
+## Requirements and supported platforms
 
-- ⚡ **Lightning Fast** - Bundles JavaScript in milliseconds using esbuild
-- 🔧 **Zero Config** - Works out of the box, no configuration needed
-- ✂️ **Minification** - Optional built-in minification
-- 📊 **Build Reports** - See exactly what's contributing to your bundle size
-- 👀 **Watch Mode** - Auto-rebuild on file changes during development
-- 🗺️ **Source Maps** - Debug with linked or inline source maps
-- 🎨 **Beautiful Output** - Colored CLI with helpful messages
-- 🤖 **Non-Interactive Mode** - Perfect for CI/CD pipelines
-- 🔄 **Config Files** - Support for JSON configuration files
+The Go source uses Go 1.22 or newer. Go can compile the CLI for Windows, Linux, and macOS on amd64 and arm64. The npm package currently contains a Linux x64 binary only; its launcher reports a clear error on other platforms. For other targets, install from source with Go.
 
----
+## Installation
 
-## 📋 Prerequisites
+Install with Go:
 
-- **Node.js**: v18 or higher (required for npm installation and Go binary)
-- **Go**: v1.21 or higher (only if building from source)
-- **Operating System**: Windows, macOS, or Linux
-
----
-
-## 🚀 Installation
-
-### Option 1: Install via npm (Recommended)
-
-```bash
-# Install globally
-npm install -g jspackr
-
-# Verify installation
-jspackr --version
-```
-
-### Option 2: Install via Go
-
-```bash
-# Install latest version
-go install github.com/kalokaradia/jspackr@latest
-
-# Verify installation
-jspackr --version
-```
-
-### Option 3: Build from Source
-
-```bash
-# Clone the repository
-git clone https://github.com/kalokaradia/jspackr.git
-cd jspackr
-
-# Build the binary
-go build -o bin/jspackr src/main/main.go
-
-# Make it executable (Linux/macOS)
-chmod +x bin/jspackr
-
-# Run directly
-./bin/jspackr --version
-```
-
-### Option 4: Manual Installation
-
-Download the appropriate binary for your platform from the [releases page](https://github.com/kalokaradia/jspackr/releases):
-
-```bash
-# Linux/macOS
-sudo mv jspackr /usr/local/bin/jspackr
-
-# Windows
-# Move jspackr.exe to your PATH
-```
-
----
-
-## 🎯 Quick Start
-
-### Basic Bundling
-
-Bundle a JavaScript file with default settings:
-
-```bash
-jspackr src/index.js
-```
-
-This creates:
-
-```
-dist/bundle.js
-```
-
-### With Options
-
-```bash
-jspackr -i src/index.js -o dist/app.js -m -r -w
-```
-
-This will:
-
-- 📥 Bundle `src/index.js`
-- 📤 Write to `dist/app.js`
-- ✂️ Minify the output
-- 📊 Show build report
-- 👀 Watch for changes
-
----
-
-## 📖 Usage
-
-### Command Syntax
-
-```bash
-jspackr [options]
-```
-
-### CLI Options
-
-| Short | Long Form             | Description                                 | Default          |
-| ----- | --------------------- | ------------------------------------------- | ---------------- |
-| `-i`  | `--input <file>`      | Entry JavaScript file                       | Required         |
-| `-o`  | `--out <file>`        | Output bundle file                          | `dist/bundle.js` |
-| `-c`  | `--config <file>`     | Path to config file                         | Optional         |
-| `-m`  | `--minify`            | Minify the output                           | `false`          |
-| `-r`  | `--report`            | Generate build report                       | `false`          |
-| `-s`  | `--source <mode>`     | Source map mode: `none`, `linked`, `inline` | `none`           |
-| `-w`  | `--watch`             | Enable watch mode                           | `false`          |
-|       | `--log-level <level>` | Log level: `debug`, `info`, `warn`, `error` | `info`           |
-| `-f`  | `--force`             | Force overwrite without confirmation        | `false`          |
-| `-y`  | `--yes`               | Auto-confirm all prompts                    | `false`          |
-| `-n`  | `--no-confirm`        | Skip all confirmation prompts               | `false`          |
-| `-v`  | `--version`           | Show version (standalone)                   | -                |
-| `-h`  | `--help`              | Show help message                           | -                |
-
-### Help Command
-
-```bash
-# Show help
-jspackr --help
-
-# Show version
-jspackr --version
-```
-
----
-
-## ⚙️ Configuration File
-
-Create a `jspackr.config.json` file for persistent configuration:
-
-```json
-{
-	"input": "./src/index.js",
-	"output": "./dist/bundle.js",
-	"minify": true,
-	"report": true,
-	"sourceMap": "linked",
-	"watch": false,
-	"logLevel": "info"
-}
-```
-
-### Config File Options
-
-| Option      | Type    | Description                                     |
-| ----------- | ------- | ----------------------------------------------- |
-| `input`     | string  | Entry JavaScript file path                      |
-| `output`    | string  | Output bundle file path                         |
-| `minify`    | boolean | Minify the output bundle                        |
-| `report`    | boolean | Generate build report                           |
-| `sourceMap` | string  | Source map mode: `none`, `linked`, `inline`     |
-| `watch`     | boolean | Enable watch mode                               |
-| `logLevel`  | string  | Log verbosity: `debug`, `info`, `warn`, `error` |
-
-### Using Config File
-
-```bash
-# Use default config (jspackr.config.json)
-jspackr
-
-# Specify custom config file
-jspackr -c custom.config.json
-```
-
----
-
-## 💡 Examples
-
-### Example 1: Basic Bundle
-
-```bash
-# Bundle a single file
-jspackr -i src/index.js
-
-# With custom output
-jspackr -i src/index.js -o dist/app.js
+```sh
+go install github.com/kalokaradia/jspackr/src/main@latest
 ```
 
-### Example 2: Production Build
+The resulting `jspackr` executable must be on your `PATH`. The npm package is also available for Linux x64:
 
-```bash
-# Minified with source map and report
-jspackr -i src/index.js -o dist/app.min.js -m -r -s inline
+```sh
+npm install -g jspackr
 ```
 
-### Example 3: Development with Watch Mode
+## Quick start
 
-```bash
-# Watch for changes and rebuild automatically
-jspackr -i src/index.js -o dist/app.js -w
+```sh
+jspackr --input src/index.js --out dist/bundle.js
+jspackr -i src/index.js -o dist/app.js --minify --report
+jspackr -i src/index.js -o dist/app.js --watch
+jspackr -i src/index.js -o dist/app.mjs --format esm
 ```
 
-### Example 4: CI/CD / Non-Interactive
-
-```bash
-# Force overwrite, skip all confirmations
-jspackr -i src/index.js -o dist/app.js -f
+The output directory is created when needed. Existing output files prompt before overwrite; use `--force`/`--yes` to skip that prompt. `--no-confirm` skips all confirmation prompts.
+If no `--config`/`-c` path is provided, jspackr loads `jspackr.config.json` from the current directory when that file exists.
 
-# Or with yes flag
-jspackr -i src/index.js -o dist/app.js -y
-
-# Or completely non-interactive
-jspackr -i src/index.js -o dist/app.js -n
-```
+## CLI options
 
-### Example 5: Using Configuration File
+| Option               | Meaning                                                 |
+| -------------------- | ------------------------------------------------------- |
+| `-i`, `--input`      | Entry JavaScript file (required)                        |
+| `-o`, `--out`        | Output file; defaults to `dist/bundle.js`               |
+| `-c`, `--config`     | Read a JSON configuration file                          |
+| `-m`, `--minify`     | Enable esbuild minification                             |
+| `-s`, `--source`     | Source map mode: `none`, `l` (linked), or `in` (inline) |
+| `--format`           | Output format: `esm`, `iife`, or `cjs` (default: `iife`) |
+| `-r`, `--report`     | Print bundle size information                           |
+| `-w`, `--watch`      | Rebuild after changes under the entry file's directory  |
+| `--log-level`        | `debug`, `info`, `warn`, or `error`                     |
+| `-f`, `--force`      | Skip output overwrite confirmation                      |
+| `-y`, `--yes`        | Automatically confirm overwrite prompts                 |
+| `-n`, `--no-confirm` | Skip all confirmation prompts                           |
+| `-h`, `--help`       | Show help                                               |
+| `-v`, `--version`    | Show CLI version                                        |
 
-**Create `jspackr.config.json`:**
+Example `jspackr.config.json`:
 
 ```json
 {
-	"input": "./src/app.js",
-	"output": "./build/app.js",
-	"minify": true,
-	"report": true
+  "input": "./src/index.js",
+  "output": "./dist/bundle.js",
+  "minify": true,
+  "report": true,
+  "sourcemap": "l",
+  "format": "esm",
+  "watch": false,
+  "logLevel": "info"
 }
 ```
 
-**Run:**
-
-```bash
-jspackr
-```
-
-### Example 6: Verbose Logging
-
-```bash
-# Debug mode
-jspackr -i src/index.js --log-level debug
-
-# Quiet mode
-jspackr -i src/index.js --log-level warn
-```
-
-### Example 7: Multiple Options Combined
-
-```bash
-# Production-ready bundle with all features
-jspackr \
-  --input src/index.js \
-  --output dist/app.js \
-  --minify \
-  --report \
-  --source linked \
-  --log-level info
-```
-
----
-
-## 📊 Build Report
-
-When using the `--report` flag, jspackr generates a detailed breakdown:
-
-```
-Bundle Size: 45.2 KB
-⏱️  Build Time: 123ms
-
-📦 Dependencies:
-  src/utils.js      12.3 KB
-  src/helpers.js    8.1 KB
-  src/index.js      2.4 KB
-  ...
-```
-
----
-
-## 🗺️ Source Maps
-
-| Mode   | Flag Value | Description                           |
-| ------ | ---------- | ------------------------------------- |
-| None   | `none`     | No source map (default)               |
-| Linked | `linked`   | Separate .map file linked via comment |
-| Inline | `inline`   | Embedded as base64 in the bundle      |
-
-```bash
-# Linked source map
-jspackr -i src/index.js -s linked
-
-# Inline source map
-jspackr -i src/index.js -s inline
-```
-
----
-
-## 📁 Project Structure
-
-```
-jspackr/
-├── bin/                    # Compiled binaries
-├── src/
-│   ├── cli/               # CLI output and styling
-│   │   ├── logger.go      # Logging functionality
-│   │   ├── styles.go      # Colored output styles
-│   │   └── ui.go          # UI components
-│   ├── config/            # Configuration management
-│   │   ├── config.go      # Config structures
-│   │   ├── loader.go      # JSON config loading
-│   │   ├── merger.go      # Config merging
-│   │   └── validator.go   # Config validation
-│   ├── core/
-│   │   ├── builder/       # Bundling logic
-│   │   │   ├── builder.go # Main builder
-│   │   │   ├── report.go  # Build reporting
-│   │   │   └── sourcemap.go # Source map handling
-│   │   └── watcher/       # File watching
-│   │       ├── debouncer.go
-│   │       ├── hasher.go
-│   │       └── watcher.go
-│   ├── main/
-│   │   └── main.go        # Entry point
-│   └── utils/
-│       ├── confirm.go     # Confirmation prompts
-│       ├── file.go        # File utilities
-│       └── flags.go       # CLI flags parsing
-├── .gitignore
-├── .npmignore
-├── go.mod
-├── go.sum
-├── LICENSE
-├── logo.svg
-├── package.json
-└── README.md
-```
-
----
-
-## 🐛 Troubleshooting
-
-### Command Not Found
-
-If `jspackr` is not found after installation:
-
-```bash
-# Add to PATH (npm global)
-npm config get prefix
-# Add the output path to your shell profile
-
-# Or for Go installation
-echo 'export PATH="$HOME/go/bin:$PATH"' >> ~/.bashrc
-source ~/.bashrc
-```
-
-### Permission Denied
-
-```bash
-# Linux/macOS
-sudo chown $(whoami) /usr/local/bin/jspackr
-
-# Or use npm with sudo (not recommended)
-sudo npm install -g jspackr
-```
-
-### Node Version Too Old
+CLI values override config values when supplied. Boolean CLI flags turn a config option on; they do not turn a config option off.
 
-```bash
-# Check version
-node --version
+Use `--format esm` to preserve ES module output and bundle entry points that use top-level `await`. The default `iife` keeps the classic self-executing bundle behavior. `cjs` emits CommonJS. When running an ESM output file with Node.js, use an `.mjs` extension or configure the containing package with `"type": "module"`.
 
-# Update using nvm (Linux/macOS)
-nvm install 18
-nvm use 18
-
-# Or download from nodejs.org
-```
+Configuration supports the same build and confirmation options: `input`, `output`, `minify`, `report`, `sourcemap`, `format`, `watch`, `logLevel`, `force`, `yes`, and `noConfirm`. Source map values are `none`, `l` (linked), and `in` (inline); log levels are `debug`, `info`, `warn`, and `error`.
 
-### Build Fails
+## Development
 
-```bash
-# Clear cache and rebuild
-go clean -cache
-go build -o bin/jspackr src/main/main.go
+The implementation is organized into `src/main` (CLI orchestration), `src/config` (JSON configuration and validation), `src/core/builder` (esbuild integration), `src/core/watcher` (file watching), `src/cli` (terminal output), and `src/utils` (shared helpers).
 
-# Check dependencies
+```sh
 go mod download
-go mod verify
-```
-
-### Watch Mode Not Working
-
-```bash
-# Ensure you're not using network drives
-# Check file permissions
-ls -la src/
-
-# Try with absolute paths
-jspackr -i /absolute/path/to/index.js
-```
-
----
-
-## 🤝 Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-### Development Setup
-
-```bash
-# Fork the repository
-git clone https://github.com/YOUR-USERNAME/jspackr.git
-cd jspackr
-
-# Create a feature branch
-git checkout -b feature/amazing-feature
-
-# Make changes
-# Test your changes
+go build ./...
 go test ./...
-
-# Commit your changes
-git commit -m "Add amazing feature"
-
-# Push to GitHub
-git push origin feature/amazing-feature
-
-# Open a Pull Request
+go vet ./...
+go test -race ./...
 ```
 
-### Coding Standards
-
-- Follow Go formatting conventions (`gofmt`)
-- Add comments for public functions
-- Write tests for new features
-- Update documentation as needed
+## Build and release
 
----
+Build locally with `go build -o jspackr ./src/main`. Set the version in release binaries with:
 
-## 📝 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
----
+```sh
+go build -ldflags "-X main.version=0.4.0" -o jspackr ./src/main
+```
 
-## 🙏 Acknowledgments
+For cross compilation, set `GOOS` and `GOARCH`, for example `GOOS=windows GOARCH=amd64`, `GOOS=linux GOARCH=arm64`, or `GOOS=darwin GOARCH=arm64`. Release maintainers should keep the git tag, npm `version`, and injected CLI version aligned. npm binary artifacts are currently maintained for Linux x64 only.
 
-- [esbuild](https://esbuild.github.io/) for the amazing bundling engine
-- [fatih/color](https://github.com/fatih/color) for colored terminal output
-- All contributors and users!
+## Troubleshooting
 
----
+- `input path does not exist`: check the entry file path relative to the current working directory.
+- npm reports an unsupported platform: use `go install` on Windows, macOS, or non-x64 Linux; those prebuilt binaries are not currently shipped in npm.
+- Output overwrite prompt: pass `--force` in scripts that intentionally replace an existing bundle.
 
-## 📧 Contact
+## Contributing
 
-- **Author**: [Kaloka Radia Nanda](https://kalokaradiananda.my.id)
-- **GitHub**: [@kalokaradia](https://github.com/kalokaradia)
-- **Issues**: [Report a bug](https://github.com/kalokaradia/jspackr/issues)
+Please use `gofmt` for Go files, add focused tests for behavior changes, and run the development checks above. Keep the CLI and configuration compatible unless a change is explicitly documented.
 
----
+## License
 
-<p align="center">
-  Made with ❤️ by <b>Kaloka Radia Nanda</b>
-</p>
+MIT. See [LICENSE](LICENSE).

package/index.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const platformMap = {
+  linux: "linux",
+  darwin: "darwin",
+  win32: "win32",
+};
+
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+};
+
+const platform = platformMap[process.platform];
+const arch = archMap[process.arch];
+
+if (!platform || !arch) {
+  console.error(
+    `jspackr: unsupported platform or architecture: ${process.platform}/${process.arch}`,
+  );
+  console.error(
+    "Supported platforms: Linux, macOS, and Windows on x64 or arm64.",
+  );
+  process.exit(1);
+}
+
+const extension = platform === "win32" ? ".exe" : "";
+
+const binaryName = `jspackr-${platform}-${arch}${extension}`;
+const binary = path.join(__dirname, "bin", binaryName);
+
+if (!fs.existsSync(binary)) {
+  console.error(`jspackr: bundled binary is missing: ${binary}`);
+  console.error("Reinstall the package or install jspackr manually with Go:");
+  console.error("go install github.com/kalokaradia/jspackr/src/main@latest");
+  process.exit(1);
+}
+
+if (platform !== "win32") {
+  try {
+    fs.chmodSync(binary, 0o755);
+  } catch (error) {
+    console.error(
+      `jspackr: cannot make bundled binary executable: ${error.message}`,
+    );
+    process.exit(1);
+  }
+}
+
+const result = spawnSync(binary, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+if (result.error) {
+  console.error(
+    `jspackr: could not start bundled binary: ${result.error.message}`,
+  );
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);

package/package.json

@@ -1,38 +1,42 @@
 {
-	"name": "jspackr",
-	"version": "0.3.0",
-	"description": "A fast and modern JavaScript bundler powered by esbuild",
-	"bin": {
-		"jspackr": "bin/jspackr"
-	},
-	"files": [
-		"bin/jspackr",
-		"README.md",
-		"LICENSE"
-	],
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/kalokaradia/jspackr.git"
-	},
-	"keywords": [
-		"bundler",
-		"esbuild",
-		"javascript",
-		"cli",
-		"build-tool",
-		"minifier"
-	],
-	"categories": [
-		"Other"
-	],
-	"author": "Kaloka Radia Nanda",
-	"license": "MIT",
-	"homepage": "https://github.com/kalokaradia/jspackr#readme",
-	"bugs": {
-		"url": "https://github.com/kalokaradia/jspackr/issues"
-	},
-	"engines": {
-		"node": ">=18"
-	},
-	"preferGlobal": true
+  "name": "jspackr",
+  "version": "0.4.0",
+  "description": "A fast and modern JavaScript bundler powered by esbuild",
+  "bin": {
+    "jspackr": "index.js"
+  },
+  "files": [
+    "bin/*",
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kalokaradia/jspackr.git"
+  },
+  "keywords": [
+    "bundler",
+    "esbuild",
+    "javascript",
+    "cli",
+    "build-tool",
+    "minifier"
+  ],
+  "categories": [
+    "Formatters"
+  ],
+  "author": "Kaloka Radia Nanda",
+  "license": "MIT",
+  "homepage": "https://github.com/kalokaradia/jspackr#readme",
+  "bugs": {
+    "url": "https://github.com/kalokaradia/jspackr/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "preferGlobal": true,
+  "dependencies": {
+    "jspackr": "file:jspackr-0.4.0.tgz"
+  }
 }