@ucdjs/cli 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-PRESENT Lucas Nørgård
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+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.

package/README.md

@@ -0,0 +1,21 @@
+# @ucdjs/cli
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+
+A CLI for working with the Unicode Character Database (UCD).
+
+## Installation
+
+```bash
+npm install -g @ucdjs/cli
+```
+
+## 📄 License
+
+Published under [MIT License](./LICENSE).
+
+[npm-version-src]: https://img.shields.io/npm/v/@ucdjs/cli?style=flat&colorA=18181B&colorB=4169E1
+[npm-version-href]: https://npmjs.com/package/@ucdjs/cli
+[npm-downloads-src]: https://img.shields.io/npm/dm/@ucdjs/cli?style=flat&colorA=18181B&colorB=4169E1
+[npm-downloads-href]: https://npmjs.com/package/@ucdjs/cli

package/bin/ucd.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import("../dist/cli.js");

package/dist/cli-utils-C8H822Rg.js

@@ -0,0 +1,174 @@
+import process from "node:process";
+import { bgGreen, black, bold, dim, green } from "farver/fast";
+import yargs from "yargs-parser";
+
+//#region package.json
+var name = "@ucdjs/cli";
+var version = "0.0.0";
+var type = "module";
+var author = {
+	"name": "Lucas Nørgård",
+	"email": "lucasnrgaard@gmail.com",
+	"url": "https://luxass.dev"
+};
+var packageManager = "pnpm@10.8.0";
+var license = "MIT";
+var homepage = "https://github.com/ucdjs/ucd";
+var repository = {
+	"type": "git",
+	"url": "git+https://github.com/ucdjs/ucd.git",
+	"directory": "packages/cli"
+};
+var bugs = { "url": "https://github.com/ucdjs/ucd/issues" };
+var bin = { "ucd": "bin/ucd.js" };
+var files = ["bin", "dist"];
+var scripts = {
+	"build": "tsdown",
+	"clean": "git clean -xdf dist node_modules",
+	"lint": "eslint .",
+	"typecheck": "tsc --noEmit"
+};
+var dependencies = {
+	"farver": "catalog:prod",
+	"yargs-parser": "catalog:prod"
+};
+var devDependencies = {
+	"@luxass/eslint-config": "catalog:dev",
+	"@types/yargs-parser": "catalog:dev",
+	"eslint": "catalog:dev",
+	"publint": "catalog:dev",
+	"tsdown": "catalog:dev",
+	"typescript": "catalog:dev",
+	"vitest-testdirs": "catalog:dev"
+};
+var publishConfig = { "access": "public" };
+var package_default = {
+	name,
+	version,
+	type,
+	author,
+	packageManager,
+	license,
+	homepage,
+	repository,
+	bugs,
+	bin,
+	files,
+	scripts,
+	dependencies,
+	devDependencies,
+	publishConfig
+};
+
+//#endregion
+//#region src/cli-utils.ts
+const SUPPORTED_COMMANDS = new Set(["generate"]);
+/**
+* Resolves the CLI command based on the provided arguments.
+*
+* If the `version` flag is present, it returns the "version" command.
+* Otherwise, it checks if the third argument in the positional arguments (`flags._[2]`)
+* is a supported command. If it is, it returns that command.
+* If no supported command is found, it defaults to the "help" command.
+*
+* @param {Arguments} flags - The parsed arguments from the command line.
+* @returns {CLICommand} The resolved CLI command.
+*/
+function resolveCommand(flags) {
+	if (flags.version) return "version";
+	const cmd = flags._[2];
+	if (SUPPORTED_COMMANDS.has(cmd)) return cmd;
+	return "help";
+}
+function printHelp({ commandName, headline, usage, tables, description }) {
+	const terminalWidth = process.stdout.columns || 80;
+	const isTinyTerminal = terminalWidth < 60;
+	const indent = "  ";
+	const linebreak = () => "";
+	const table = (rows, { padding }) => {
+		let raw = "";
+		for (const [command, help] of rows) if (isTinyTerminal) raw += `${indent}${indent}${bold(command)}\n${indent}${indent}${indent}${dim(help)}\n`;
+		else {
+			const paddedCommand = command.padEnd(padding);
+			raw += `${indent}${indent}${bold(paddedCommand)}  ${dim(help)}\n`;
+		}
+		return raw.slice(0, -1);
+	};
+	const message = [];
+	if (headline) message.push(`\n${indent}${bgGreen(black(` ${commandName} `))} ${green(`v${package_default.version ?? "0.0.0"}`)}`, `${indent}${dim(headline)}`);
+	if (usage) message.push(linebreak(), `${indent}${bold("USAGE")}`, `${indent}${indent}${green(commandName)} ${usage}`);
+	if (description) message.push(linebreak(), `${indent}${bold("DESCRIPTION")}`, `${indent}${indent}${description}`);
+	if (tables) {
+		function calculateTablePadding(rows) {
+			const maxLength = rows.reduce((val, [first]) => Math.max(val, first.length), 0);
+			return Math.min(maxLength, 30) + 2;
+		}
+		const tableEntries = Object.entries(tables);
+		for (const [tableTitle, tableRows] of tableEntries) {
+			const padding = calculateTablePadding(tableRows);
+			message.push(linebreak(), `${indent}${bold(tableTitle.toUpperCase())}`, table(tableRows, { padding }));
+		}
+	}
+	message.push(linebreak(), `${indent}${dim(`Run with --help for more information on specific commands.`)}`);
+	console.log(`${message.join("\n")}\n`);
+}
+/**
+* Runs a command based on the provided CLI command and flags.
+*
+* @param {CLICommand} cmd - The CLI command to execute.
+* @param {Arguments} flags - The flags passed to the command.
+* @returns {Promise<void>} A promise that resolves when the command has finished executing.
+* @throws An error if the command is not found.
+*/
+async function runCommand(cmd, flags) {
+	switch (cmd) {
+		case "help":
+			printHelp({
+				commandName: "ucd",
+				headline: "A CLI for working with the Unicode Character Database (UCD).",
+				usage: "[command] [...flags]",
+				tables: {
+					"Commands": [["generate", "Generate UCD data files."]],
+					"Global Flags": [
+						["--force", "Force the operation to run, even if it's not needed."],
+						["--version", "Show the version number and exit."],
+						["--help", "Show this help message."]
+					]
+				}
+			});
+			break;
+		case "version":
+			console.log(`  ${bgGreen(black(` ucd `))} ${green(`v${package_default.version ?? "x.y.z"}`)}`);
+			break;
+		case "generate": {
+			const { runGenerate } = await import("./generate-ADwYDcJ5.js");
+			const versions = flags._.slice(3);
+			await runGenerate({
+				versions,
+				flags
+			});
+			break;
+		}
+		default: throw new Error(`Error running ${cmd} -- no command found.`);
+	}
+}
+function parseFlags(args) {
+	return yargs(args, {
+		configuration: { "parse-positional-numbers": false },
+		string: ["output-dir"],
+		default: { "output-dir": "./data" }
+	});
+}
+async function runCLI(args) {
+	try {
+		const flags = parseFlags(args);
+		const cmd = resolveCommand(flags);
+		await runCommand(cmd, flags);
+	} catch (err) {
+		console.error(err);
+		process.exit(1);
+	}
+}
+
+//#endregion
+export { printHelp, runCLI };

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/cli.js

@@ -0,0 +1,7 @@
+import { runCLI } from "./cli-utils-C8H822Rg.js";
+import process from "node:process";
+
+//#region src/cli.ts
+runCLI(process.argv);
+
+//#endregion

package/dist/generate-ADwYDcJ5.js

@@ -0,0 +1,21 @@
+import { printHelp } from "./cli-utils-C8H822Rg.js";
+import { green } from "farver/fast";
+import path from "node:path";
+
+//#region src/cmd/generate.ts
+async function runGenerate({ versions: providedVersions, flags }) {
+	if (flags?.help || flags?.h) {
+		printHelp({
+			headline: "Generate Unicode Data Files",
+			commandName: "ucd generate",
+			usage: "<...versions> [...flags]",
+			tables: { Flags: [["--output-dir", "Specify the output directory."], ["--help (-h)", "See all available flags."]] }
+		});
+		return;
+	}
+	const _outputDir = flags.outputDir ?? path.join(process.cwd(), "data");
+	console.log(green(`Generating emoji data for versions: ${providedVersions.join(", ")}`));
+}
+
+//#endregion
+export { runGenerate };

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@ucdjs/cli",
+  "version": "0.0.0",
+  "type": "module",
+  "author": {
+    "name": "Lucas Nørgård",
+    "email": "lucasnrgaard@gmail.com",
+    "url": "https://luxass.dev"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/ucdjs/ucd",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ucdjs/ucd.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/ucdjs/ucd/issues"
+  },
+  "bin": {
+    "ucd": "bin/ucd.js"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "dependencies": {
+    "farver": "^0.4.2",
+    "yargs-parser": "^21.1.1"
+  },
+  "devDependencies": {
+    "@luxass/eslint-config": "^4.18.1",
+    "@types/yargs-parser": "^21.0.3",
+    "eslint": "^9.23.0",
+    "publint": "^0.3.12",
+    "tsdown": "v0.9.3",
+    "typescript": "^5.8.2",
+    "vitest-testdirs": "^3.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "git clean -xdf dist node_modules",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  }
+}