@lewishowles/cli-style 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 0.2.0 - 2026-06-27
+
+### Added
+
+- Added standalone binary packaging with `bun run package:binary`.
+- Added release tarballs containing `bin/cli-style` and Bash/Python adapters.
+- Added tagged GitHub release workflow for npm trusted publishing and binary assets.
+- Added `cli-style adapter-path bash|python` for adapter discovery.
+
+### Changed
+
+- Configured package publishing for public npm.
+- Documented binary install flow for non-JS projects.

package/README.md

@@ -4,8 +4,8 @@ Shared terminal output styles for tools, diagnostics, and package CLIs.
 
 ## Requirements
 
-- Bun
-- Node.js 20 or newer
+- Bun and Node.js 20 or newer for JavaScript projects and local binary builds
+- The standalone binary for Bash or Python projects that should not install Bun
 
 ## Install
 
@@ -15,11 +15,10 @@ JavaScript projects can install the package directly:
 bun add @lewishowles/cli-style
 ```
 
-Bash and Python projects still need the package available somewhere, because their adapters call the `cli-style` binary. If the project already has Node or Bun tooling, add it as a dev dependency. Otherwise, link or vendor this package in a stable tools directory and point the adapters at that copy:
+Bash and Python projects call the `cli-style` binary through thin adapters. If the project already has Node or Bun tooling, add this package as a dev dependency and use the package binary. Otherwise, install or vendor the standalone binary and put it on `PATH`:
 
 ```bash
-export CLI_STYLE_BIN="/path/to/cli-style/bin/cli-style.js"
-export PYTHONPATH="/path/to/cli-style/adapters/python:$PYTHONPATH"
+export PATH="/path/to/cli-style/bin:$PATH"
 ```
 
 ## JavaScript
@@ -68,10 +67,26 @@ JSON
 
 `render` supports `--profile`, `--plain`, `--no-colour`, `--no-color`, `--no-unicode`, and `--width`. It rejects `--json`; JSON profile behaviour is for library calls and machine-readable commands.
 
+Build a local standalone binary when a repo should not need Bun at runtime:
+
+```bash
+bun run build:binary
+bun run smoke:binary
+```
+
+Create a binary install tarball:
+
+```bash
+bun run package:binary
+tar -tzf dist/release/cli-style-*.tar.gz
+```
+
+The package contains `bin/cli-style` and `adapters/`. Install it into a repo-local tools directory, then call that repo-local `bin/cli-style` from scripts.
+
 ## Bash
 
 ```bash
-source /path/to/node_modules/@lewishowles/cli-style/adapters/bash/cli-style.sh
+source "$(cli-style adapter-path bash)"
 
 cli_style_render status --profile diagnostic <<'JSON'
 {
@@ -95,7 +110,11 @@ JSON
 
 ## Python
 
-Add `/path/to/node_modules/@lewishowles/cli-style/adapters/python` to `PYTHONPATH`, then import the helper:
+Add the adapter directory to `PYTHONPATH`, then import the helper:
+
+```bash
+export PYTHONPATH="$(cli-style adapter-path python):$PYTHONPATH"
+```
 
 ```python
 from cli_style import render

package/bin/cli-style.js

@@ -1,20 +1,17 @@
 #!/usr/bin/env bun
 
 import { Buffer } from "node:buffer";
-
 import { createCliStyle, renderGallery, renderHelp } from "../src/index.js";
+import { parseAdapterPathRequest, renderAdapterPath } from "../src/cli/adapter-path-command.js";
+import { parseRenderRequest, renderJsonInput } from "../src/cli/render-command.js";
+
 import {
 	parseGalleryRequest,
 	selectInteractiveGalleryRequest,
 } from "../src/cli/gallery-command.js";
-import {
-	parseRenderRequest,
-	renderJsonInput,
-} from "../src/cli/render-command.js";
 
 // Command-line arguments passed to the package binary.
 const args = process.argv.slice(2);
-
 // First positional command requested by the caller.
 const command = args[0];
 
@@ -38,6 +35,15 @@ function print(value) {
 
 if (command === undefined || command === "--help" || command === "-h") {
 	print(renderHelp());
+} else if (command === "adapter-path") {
+	try {
+		const request = parseAdapterPathRequest(args.slice(1));
+
+		print(renderAdapterPath(request));
+	} catch (error) {
+		console.error(error.message);
+		process.exitCode = 1;
+	}
 } else if (command === "gallery") {
 	try {
 		const request = parseGalleryRequest(args.slice(1));

package/package.json

@@ -1,20 +1,22 @@
 {
 	"name": "@lewishowles/cli-style",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"description": "Shared terminal output styles for Lewis Howles tools, diagnostics, and package CLIs.",
 	"license": "MIT",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/lewishowles/cli-style.git"
+		"url": "git+https://github.com/lewishowles/cli-style.git"
 	},
 	"bin": {
-		"cli-style": "./bin/cli-style.js"
+		"cli-style": "bin/cli-style.js"
 	},
 	"files": [
 		"adapters",
 		"bin",
 		"examples",
+		"scripts",
 		"src",
+		"CHANGELOG.md",
 		"README.md"
 	],
 	"type": "module",
@@ -23,11 +25,14 @@
 		".": "./src/index.js"
 	},
 	"publishConfig": {
-		"registry": "https://npm.pkg.github.com/"
+		"access": "public"
 	},
 	"scripts": {
+		"build:binary": "scripts/build-binary.sh",
 		"check": "vp check --fix",
 		"cli-style:gallery": "bun ./bin/cli-style.js gallery",
+		"package:binary": "scripts/package-binary.sh",
+		"smoke:binary": "./dist/bin/cli-style render status --plain < tests/fixtures/render/status-success.json",
 		"test:unit": "bun test"
 	},
 	"devDependencies": {

package/scripts/build-binary.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Builds the standalone cli-style binary and copies wrapper adapters beside it.
+#
+# Release layout:
+#   dist/bin/cli-style
+#   dist/adapters/bash/cli-style.sh
+#   dist/adapters/python/cli_style.py
+
+set -euo pipefail
+
+mkdir -p dist/bin dist/adapters/bash dist/adapters/python
+
+build_args=(--compile ./bin/cli-style.js --outfile ./dist/bin/cli-style)
+
+if [ "${BUN_COMPILE_TARGET:-}" != "" ]; then
+	build_args+=(--target "$BUN_COMPILE_TARGET")
+fi
+
+bun build "${build_args[@]}"
+
+cp adapters/bash/cli-style.sh dist/adapters/bash/cli-style.sh
+cp adapters/python/cli_style.py dist/adapters/python/cli_style.py

package/scripts/package-binary.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# Packages the standalone binary layout into a platform tarball.
+#
+# Archive layout:
+#   bin/cli-style
+#   adapters/bash/cli-style.sh
+#   adapters/python/cli_style.py
+
+set -euo pipefail
+
+platform="${CLI_STYLE_PLATFORM:-$(uname -s | tr '[:upper:]' '[:lower:]')}"
+architecture="${CLI_STYLE_ARCH:-$(uname -m)}"
+
+case "$platform" in
+	darwin) platform="darwin" ;;
+	linux) platform="linux" ;;
+	*) printf 'Unsupported platform: %s\n' "$platform" >&2; exit 1 ;;
+esac
+
+case "$architecture" in
+	arm64|aarch64) architecture="arm64" ;;
+	x64|x86_64|amd64) architecture="x64" ;;
+	*) printf 'Unsupported architecture: %s\n' "$architecture" >&2; exit 1 ;;
+esac
+
+case "$platform-$architecture" in
+	darwin-arm64) compile_target="bun-darwin-arm64" ;;
+	darwin-x64)   compile_target="bun-darwin-x64" ;;
+	linux-arm64)  compile_target="bun-linux-arm64" ;;
+	linux-x64)    compile_target="bun-linux-x64" ;;
+	*) printf 'Unsupported binary target: %s-%s\n' "$platform" "$architecture" >&2; exit 1 ;;
+esac
+
+BUN_COMPILE_TARGET="$compile_target" scripts/build-binary.sh
+
+mkdir -p dist/release
+
+archive="dist/release/cli-style-${platform}-${architecture}.tar.gz"
+
+tar -C dist -czf "$archive" bin adapters
+
+printf '%s\n' "$archive"

package/src/cli/adapter-path-command.js

@@ -0,0 +1,78 @@
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// Adapter paths returned for shell and Python wrapper setup.
+const adapterPaths = {
+	bash: {
+		releasePath: "adapters/bash/cli-style.sh",
+		sourceUrl: new URL("../../adapters/bash/cli-style.sh", import.meta.url),
+	},
+	python: {
+		releasePath: "adapters/python",
+		sourceUrl: new URL("../../adapters/python", import.meta.url),
+	},
+};
+
+// Adapter names accepted by the adapter-path command.
+export const adapterNames = Object.keys(adapterPaths);
+
+/**
+ * Parse adapter-path command arguments.
+ *
+ * @param  {string[]}  args
+ *     Arguments after the adapter-path command.
+ * @returns  {object}
+ *     Adapter path request.
+ */
+export function parseAdapterPathRequest(args = []) {
+	const request = {
+		adapter: args[0],
+	};
+
+	validateRequest(request, args);
+
+	return request;
+}
+
+/**
+ * Render the filesystem path for an adapter.
+ *
+ * @param  {object}  request
+ *     Parsed adapter path request.
+ * @returns  {string}
+ *     Adapter file or directory path.
+ */
+export function renderAdapterPath(request) {
+	const adapterPath = adapterPaths[request.adapter];
+	const sourcePath = fileURLToPath(adapterPath.sourceUrl);
+
+	if (existsSync(sourcePath)) {
+		return sourcePath;
+	}
+
+	return join(dirname(process.execPath), "..", adapterPath.releasePath);
+}
+
+/**
+ * Validate adapter-path request values.
+ *
+ * @param  {object}  request
+ *     Parsed adapter path request.
+ * @param  {string[]}  args
+ *     Raw command arguments.
+ * @returns  {void}
+ */
+function validateRequest(request, args) {
+	if (request.adapter === undefined) {
+		throw new Error("Missing adapter");
+	}
+
+	if (!Object.hasOwn(adapterPaths, request.adapter)) {
+		throw new Error(`Unknown adapter: ${request.adapter}`);
+	}
+
+	if (args.length > 1) {
+		throw new Error(`Unexpected adapter-path argument: ${args[1]}`);
+	}
+}

package/src/cli/help.js

@@ -4,10 +4,12 @@ const helpLines = [
 	"",
 	"Usage:",
 	"  cli-style --help",
+	"  cli-style adapter-path bash|python",
 	"  cli-style gallery [variant] [options]",
 	"  cli-style render <renderer> [options] < input.json",
 	"",
 	"Commands:",
+	"  adapter-path    Print a Bash or Python adapter path.",
 	"  gallery    Print the read-only style gallery.",
 	"  render     Render caller-provided JSON from stdin.",
 	"",

package/src/index.js

@@ -5,6 +5,11 @@ export { resolveTerminalCapabilities } from "./capability/terminal.js";
 export { isProfile } from "./profiles/profiles.js";
 
 export { renderHelp } from "./cli/help.js";
+export {
+	adapterNames,
+	parseAdapterPathRequest,
+	renderAdapterPath,
+} from "./cli/adapter-path-command.js";
 export {
 	parseRenderRequest,
 	rendererNames,