@projectwallace/format-css 2.2.6 → 3.0.0

package/README.md

@@ -65,7 +65,9 @@ Need more examples?
 1. Multiline tokens like **Selectors, Values, etc.** are rendered on a single line
 1. Unknown syntax is rendered as-is, with multi-line formatting kept intact
 
-## Minify CSS
+## Options
+
+### Minify CSS
 
 This package also exposes a minifier function since minifying CSS follows many of the same rules as formatting.
 
@@ -79,7 +81,7 @@ let minified = minify('a {}')
 let formatted_mini = format('a {}', { minify: true })
 ```
 
-## Tab size
+### Tab size
 
 For cases where you cannot control the tab size with CSS there is an option to override the default tabbed indentation with N spaces.
 
@@ -91,8 +93,36 @@ let formatted = format('a { color: red; }', {
 })
 ```
 
+## CLI
+
+This library also ships a CLI tools that's a small wrapper around the library.
+
+```
+USAGE
+  format-css [options] [file...]
+  cat styles.css | format-css [options]
+
+OPTIONS
+  --minify            Minify the CSS output
+  --tab-size=<n>      Use N spaces for indentation instead of tabs
+  --help, -h          Show this help
+
+EXAMPLES
+  # Format a file
+  format-css styles.css
+
+  # Format with 2-space indentation
+  format-css styles.css --tab-size=2
+
+  # Minify
+  format-css styles.css --minify
+
+  # Via pipe
+  cat styles.css | format-css
+```
+
 ## Related projects
 
-- [Format CSS online](https://www.projectwallace.com/prettify-css?utm_source=github&utm_medium=wallace_format_css_related_projects) - See this formatter in action online!
-- [Minify CSS online](https://www.projectwallace.com/minify-css?utm_source=github&utm_medium=wallace_format_css_related_projects) - See this minifier in action online!
-- [CSS Analyzer](https://github.com/projectwallace/css-analyzer) - The best CSS analyzer that powers all analysis on [projectwallace.com](https://www.projectwallace.com?utm_source=github&utm_medium=wallace_format_css_related_projects)
+- [Format CSS online](https://www.projectwallace.com/prettify-css) - See this formatter in action online!
+- [Minify CSS online](https://www.projectwallace.com/minify-css) - See this minifier in action online!
+- [CSS Analyzer](https://github.com/projectwallace/css-analyzer) - The best CSS analyzer that powers all analysis on [projectwallace.com](https://www.projectwallace.com)

package/dist/cli.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { parseArgs, styleText } from "node:util";
+import { readFileSync } from "node:fs";
+import { resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { format } from "@projectwallace/format-css";
+//#region src/cli/cli.ts
+function help() {
+	return `
+${styleText("bold", "USAGE")}
+  format-css [options] [file...]
+  cat styles.css | format-css [options]
+
+${styleText("bold", "OPTIONS")}
+  --minify            Minify the CSS output
+  --tab-size=<n>      Use N spaces for indentation instead of tabs
+  --help, -h          Show this help
+
+${styleText("bold", "EXAMPLES")}
+  ${styleText("dim", "# Format a file")}
+  format-css styles.css
+
+  ${styleText("dim", "# Format with 2-space indentation")}
+  format-css styles.css --tab-size=2
+
+  ${styleText("dim", "# Minify")}
+  format-css styles.css --minify
+
+  ${styleText("dim", "# Via pipe")}
+  cat styles.css | format-css
+	`.trim();
+}
+function parse_arguments(args) {
+	const { values, positionals } = parseArgs({
+		args,
+		allowPositionals: true,
+		options: {
+			minify: {
+				type: "boolean",
+				default: false
+			},
+			"tab-size": { type: "string" }
+		}
+	});
+	const issues = [];
+	let tab_size;
+	if (values["tab-size"] !== void 0) {
+		tab_size = Number(values["tab-size"]);
+		if (isNaN(tab_size) || tab_size < 1) issues.push("--tab-size must be a positive integer");
+	}
+	const cwd = process.cwd();
+	const files = [];
+	for (const file of positionals) {
+		const resolved = resolve(file);
+		if (resolved !== cwd && !resolved.startsWith(cwd + sep)) issues.push(`Invalid path: ${file}`);
+		else files.push(resolved);
+	}
+	if (issues.length > 0) throw new Error(issues.join("\n"));
+	return {
+		files,
+		minify: values.minify ?? false,
+		tab_size
+	};
+}
+async function run(args, io) {
+	if (args.includes("--help") || args.includes("-h")) {
+		io.write(help() + "\n");
+		return;
+	}
+	const { files, minify, tab_size } = parse_arguments(args);
+	const options = {
+		minify,
+		tab_size
+	};
+	if (files.length > 0) for (const file of files) io.write(format(io.readFile(file), options));
+	else if (!io.isTTY) io.write(format(await io.readStdin(), options));
+	else io.write(help() + "\n");
+}
+async function read_stdin() {
+	const chunks = [];
+	for await (const chunk of process.stdin) chunks.push(chunk);
+	return Buffer.concat(chunks).toString("utf-8");
+}
+if (process.argv[1] === fileURLToPath(import.meta.url)) try {
+	await run(process.argv.slice(2), {
+		readFile: (path) => readFileSync(path, "utf-8"),
+		readStdin: read_stdin,
+		write: (output) => process.stdout.write(output),
+		isTTY: process.stdin.isTTY === true
+	});
+} catch (error) {
+	console.error(error instanceof Error ? error.message : String(error));
+	process.exit(1);
+}
+//#endregion
+export { parse_arguments, run };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-//#region index.d.ts
+//#region src/lib/index.d.ts
 type FormatOptions = {
   /** Whether to minify the CSS or keep it formatted */minify?: boolean; /** Tell the formatter to use N spaces instead of tabs  */
   tab_size?: number;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { ATTR_FLAG_NAMES, ATTR_OPERATOR_NAMES, NODE_TYPES, parse } from "@projectwallace/css-parser";
-//#region index.ts
+//#region src/lib/index.ts
 const SPACE = " ";
 const EMPTY_STRING = "";
 const COLON = ":";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@projectwallace/format-css",
-	"version": "2.2.6",
+	"version": "3.0.0",
 	"description": "Fast, small, zero-config library to format or minify CSS with basic rules.",
 	"keywords": [
 		"css",
@@ -20,6 +20,9 @@
 		"type": "git",
 		"url": "git+https://github.com/projectwallace/format-css.git"
 	},
+	"bin": {
+		"format-css": "./dist/cli.mjs"
+	},
 	"files": [
 		"dist"
 	],
@@ -42,6 +45,7 @@
 	},
 	"devDependencies": {
 		"@codecov/rollup-plugin": "^1.9.1",
+		"@types/node": "^25.5.0",
 		"@vitest/coverage-v8": "^4.0.3",
 		"oxfmt": "^0.36.0",
 		"oxlint": "^1.24.0",
@@ -51,7 +55,7 @@
 		"vitest": "^4.0.3"
 	},
 	"engines": {
-		"node": ">=18.0.0"
+		"node": ">=20.12.0"
 	},
 	"issues": "https://github.com/projectwallace/format-css/issues"
 }