jspackr 0.2.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,66 +1,120 @@
 # jspackr
 
-A minimal JavaScript bundler powered by esbuild.
-Fast, simple, and focused on doing one thing well.
+<img src='./logo.svg' width=150>
 
-## Why jspackr?
+`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.
 
-jspackr exists because sometimes you just want to:
+## Features
 
-- bundle a JavaScript entry file
-- optionally minify it
-- see which files actually make your bundle big
+- 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.
 
-No config files.
-No plugins.
-No framework cosplay.
+## Requirements and supported platforms
 
-Run it, get your bundle, move on.
+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.
 
-## Features
+## Installation
 
-- ⚡ Extremely fast bundling via esbuild
-- ✂️ Optional minification
-- 📊 Simple build report to see top contributors
-- 🧠 Sensible CLI UX with shorthand flags
-- 🔄️ Watch mode for development
-- 🗺️ Source maps support (none, linked, inline)
+Install with Go:
 
-## Installation
+```sh
+go install github.com/kalokaradia/jspackr/src/main@latest
+```
 
-For now, build from source:
+The resulting `jspackr` executable must be on your `PATH`. The npm package is also available for Linux x64:
 
-```bash
+```sh
 npm install -g jspackr
 ```
 
-## Usage
+## Quick start
 
--> Basic usage:
+```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
+```
 
-```bash
-jspackr src/index.js
+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.
+
+## CLI options
+
+| 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                                        |
+
+Example `jspackr.config.json`:
+
+```json
+{
+  "input": "./src/index.js",
+  "output": "./dist/bundle.js",
+  "minify": true,
+  "report": true,
+  "sourcemap": "l",
+  "format": "esm",
+  "watch": false,
+  "logLevel": "info"
+}
 ```
 
--> With options:
+CLI values override config values when supplied. Boolean CLI flags turn a config option on; they do not turn a config option off.
+
+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"`.
+
+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`.
+
+## Development
 
-```bash
-jspackr -i src/index.js -o dist/app.js -m -r -w
+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).
+
+```sh
+go mod download
+go build ./...
+go test ./...
+go vet ./...
+go test -race ./...
+```
+
+## Build and release
+
+Build locally with `go build -o jspackr ./src/main`. Set the version in release binaries with:
+
+```sh
+go build -ldflags "-X main.version=0.4.0" -o jspackr ./src/main
 ```
 
-## CLI Options
+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.
+
+## 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.
+
+## Contributing
 
-| Flag | Long Form       | Description                               |
-| ---- | --------------- | ----------------------------------------- |
-| -i   | --input \<file> | Entry file                                |
-| -o   | --out \<file>   | Output file (default: dist/bundle.js)     |
-| -m   | --minify        | Minify output                             |
-| -r   | --report        | Show build report                         |
-| -s   | --source <mode> | Source map: none, l (linked), in (inline) |
-| -w   | --watch         | Enable watch mode                         |
-| -h   | --help          | Show help                                 |
+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
 
-Created with ❤️ by Kaloka Radia Nanda  
-Licensed under the MIT License.
+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,24 +1,42 @@
 {
-	"name": "jspackr",
-	"version": "0.2.0",
-	"description": "A minimal JavaScript bundler powered by esbuild",
-	"bin": {
-		"jspackr": "bin/jspackr"
-	},
-	"files": [
-		"bin/jspackr",
-		"README.md",
-		"LICENSE"
-	],
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/kalokaradia/jspackr"
-	},
-	"keywords": [
-		"bundler",
-		"esbuild",
-		"javascript",
-		"cli"
-	],
-	"license": "MIT"
+  "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"
+  }
 }