@gaomingzhao666/stack-info 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nano@Gaomingzhao
+
+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/dist/cli.d.mts

@@ -0,0 +1,8 @@
+
+import * as citty from "citty";
+
+//#region src/index.d.ts
+declare const main: citty.CommandDef<citty.ArgsDef>;
+declare const run: () => Promise<void>;
+//#endregion
+export { main, run };

package/dist/cli.mjs

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+import { defineCommand, runMain } from "citty";
+import os from "node:os";
+import process$1 from "node:process";
+import clipboard from "clipboardy";
+import { box, log } from "@clack/prompts";
+import { colors } from "consola/utils";
+import { detectPackageManager } from "nypm";
+import { resolve } from "pathe";
+import { readPackageJSON } from "pkg-types";
+import { isBun, isDeno, isMinimal } from "std-env";
+import { stripVTControlCharacters } from "node:util";
+import { execSync } from "node:child_process";
+
+//#region src/utils/formatting.ts
+const getStringWidth = (str) => {
+	const stripped = stripVTControlCharacters(str);
+	let width = 0;
+	for (const char of stripped) {
+		const code = char.codePointAt(0);
+		if (!code) continue;
+		if (code >= 65024 && code <= 65039) continue;
+		if (code >= 127744 && code <= 129535 || code >= 128512 && code <= 128591 || code >= 128640 && code <= 128767 || code >= 9728 && code <= 9983 || code >= 9984 && code <= 10175 || code >= 129280 && code <= 129535 || code >= 129648 && code <= 129791) width += 2;
+		else width += 1;
+	}
+	return width;
+};
+const formatInfoBox = (infoObj) => {
+	let firstColumnLength = 0;
+	let ansiFirstColumnLength = 0;
+	const entries = Object.entries(infoObj).map(([label, val]) => {
+		if (label.length > firstColumnLength) {
+			ansiFirstColumnLength = colors.bold(colors.whiteBright(label)).length + 6;
+			firstColumnLength = label.length + 6;
+		}
+		return [label, val || "-"];
+	});
+	const terminalWidth = Math.max(process$1.stdout.columns || 80, firstColumnLength) - 8;
+	let boxStr = "";
+	for (const [label, value] of entries) {
+		const formattedValue = value.replace(/\b@([^, ]+)/g, (_, r) => colors.gray(` ${r}`)).replace(/`([^`]*)`/g, (_, r) => r);
+		boxStr += `${colors.bold(colors.whiteBright(label))}`.padEnd(ansiFirstColumnLength);
+		let boxRowLength = firstColumnLength;
+		const words = formattedValue.split(" ");
+		let currentLine = "";
+		for (const word of words) {
+			const wordLength = getStringWidth(word);
+			const spaceLength = currentLine ? 1 : 0;
+			if (boxRowLength + wordLength + spaceLength > terminalWidth) {
+				if (currentLine) boxStr += colors.cyan(currentLine);
+				boxStr += `\n${" ".repeat(firstColumnLength)}`;
+				currentLine = word;
+				boxRowLength = firstColumnLength + wordLength;
+			} else {
+				currentLine += (currentLine ? " " : "") + word;
+				boxRowLength += wordLength + spaceLength;
+			}
+		}
+		if (currentLine) boxStr += colors.cyan(currentLine);
+		boxStr += "\n";
+	}
+	return boxStr;
+};
+
+//#endregion
+//#region src/utils/packageManager.ts
+const getPackageManagerVersion = (name) => execSync(`${name} --version`).toString("utf8").trim();
+
+//#endregion
+//#region src/utils/builder.ts
+/**
+* Detect the build tool used by the project.
+* Order matters: modern tools first.
+*/
+const getBuilder = async (cwd) => {
+	const pkg = await readPackageJSON(cwd).catch(() => null);
+	if (!pkg) return null;
+	const deps = {
+		...pkg.dependencies || {},
+		...pkg.devDependencies || {}
+	};
+	const has = (name) => Boolean(deps[name]);
+	const versionOf = (name) => deps[name] ?? "-";
+	if (has("vite")) return {
+		name: has("rolldown") || has("@rolldown/core") || has("vite-rolldown") ? "Rolldown (Vite-compatible)" : "Vite",
+		version: versionOf("vite")
+	};
+	if (has("@rspack/core") || has("rspack")) return {
+		name: "Rspack",
+		version: versionOf("@rspack/core") || versionOf("rspack")
+	};
+	if (has("webpack")) return {
+		name: "Webpack",
+		version: versionOf("webpack")
+	};
+	if (has("parcel")) return {
+		name: "Parcel",
+		version: versionOf("parcel")
+	};
+	return null;
+};
+
+//#endregion
+//#region src/commands/info.ts
+const cwdArgs = { cwd: {
+	type: "string",
+	description: "Specify the working directory",
+	valueHint: "directory",
+	default: "."
+} };
+var info_default = defineCommand({
+	meta: {
+		name: "info",
+		description: "Get information about your project"
+	},
+	args: { ...cwdArgs },
+	run: async (ctx) => {
+		const cwd = resolve(ctx.args.cwd || process$1.cwd());
+		const { dependencies = {}, devDependencies = {} } = await readPackageJSON(cwd).catch(() => ({}));
+		const allDeps = {
+			...dependencies,
+			...devDependencies
+		};
+		const getDepVersion = (name) => allDeps[name] || "-";
+		const frameworks = [
+			{
+				name: "Vue",
+				pkg: "vue"
+			},
+			{
+				name: "React",
+				pkg: "react"
+			},
+			{
+				name: "Svelte",
+				pkg: "svelte"
+			},
+			{
+				name: "Angular",
+				pkg: "@angular/core"
+			},
+			{
+				name: "Nuxt",
+				pkg: "nuxt"
+			},
+			{
+				name: "Next",
+				pkg: "next"
+			},
+			{
+				name: "Astro",
+				pkg: "astro"
+			}
+		].filter((f) => allDeps[f.pkg]).map((f) => `${f.name}@${getDepVersion(f.pkg)}`).join(", ") || "None detected";
+		let packageManager = (await detectPackageManager(cwd))?.name;
+		if (packageManager) packageManager += `@${getPackageManagerVersion(packageManager)}`;
+		const builder = await getBuilder(cwd);
+		const builderInfo = builder ? `${builder.name}@${builder.version}` : "None detected";
+		const osType = os.type();
+		const infoObj = {
+			"Project root": cwd,
+			"Operating system": osType === "Darwin" ? `macOS ${os.release()}` : osType === "Windows_NT" ? `Windows ${os.release()}` : `${osType} ${os.release()}`,
+			CPU: `${os.cpus()[0]?.model || "unknown"} (${os.cpus().length} cores)`,
+			...isBun ? { "Bun version": Bun?.version } : isDeno ? { "Deno version": Deno?.version.deno } : { "Node.js version": process$1.version },
+			"Package manager": packageManager ?? "unknown",
+			Builder: builderInfo,
+			Frameworks: frameworks
+		};
+		const boxStr = formatInfoBox(infoObj);
+		let firstColumnLength = 0;
+		let secondColumnLength = 0;
+		const entries = Object.entries(infoObj).map(([label, val]) => {
+			firstColumnLength = Math.max(firstColumnLength, label.length + 4);
+			secondColumnLength = Math.max(secondColumnLength, String(val).length + 2);
+			return [label, String(val || "-")];
+		});
+		let copyStr = `| ${" ".repeat(firstColumnLength)} | ${" ".repeat(secondColumnLength)} |\n| ${"-".repeat(firstColumnLength)} | ${"-".repeat(secondColumnLength)} |\n`;
+		for (const [label, value] of entries) if (!isMinimal) copyStr += `| ${`**${label}**`.padEnd(firstColumnLength)} | ${(value.includes("`") ? value : `\`${value}\``).padEnd(secondColumnLength)} |\n`;
+		if (!isMinimal && await clipboard.write(copyStr).then(() => true).catch(() => false)) box(`\n${boxStr}`, ` Project info ${colors.gray("(copied to clipboard)")}`, {
+			contentAlign: "left",
+			titleAlign: "left",
+			width: "auto",
+			titlePadding: 2,
+			contentPadding: 2,
+			rounded: true
+		});
+		else log.info(`Project info:\n${copyStr}`);
+	}
+});
+
+//#endregion
+//#region src/index.ts
+const main = defineCommand({
+	meta: {
+		name: "stack-info",
+		version: "1.0.0",
+		description: "A cross-platform, framework-agnostic CLI for inspecting web project stacks in command line."
+	},
+	subCommands: { info: info_default }
+});
+const run = async () => await runMain(main);
+run().catch((err) => {
+	console.error(err);
+	process.exit(1);
+});
+
+//#endregion
+export { main, run };

package/package.json

@@ -0,0 +1,56 @@
+{
+	"name": "@gaomingzhao666/stack-info",
+	"version": "1.0.0",
+	"description": "A cross-platform, framework-agnostic CLI for inspecting web project stacks in command line.",
+	"keywords": [
+		"cli",
+		"info",
+		"project-info",
+		"command-line",
+		"tool",
+		"web",
+		"framework",
+		"frontend",
+		"stack",
+		"vite",
+		"builder",
+		"printer",
+		"command-line"
+	],
+	"license": "MIT",
+	"author": "gaomingzhao <gaomingzhao666@outlook.com> (https://github.com/gaomingzhao)",
+	"type": "module",
+	"main": "./dist/cli.mjs",
+	"scripts": {
+		"build": "tsdown",
+		"prepack": "pnpm build"
+	},
+	"bin": {
+		"stack-info": "./dist/cli.mjs"
+	},
+	"types": "./dist/cli.d.mts",
+	"files": [
+		"dist"
+	],
+	"engines": {
+		"node": ">=18"
+	},
+	"dependencies": {
+		"@clack/prompts": "^1.0.0",
+		"citty": "^0.2.0",
+		"clipboardy": "^5.2.1",
+		"consola": "^3.4.2",
+		"nypm": "^0.6.5",
+		"pathe": "^2.0.3",
+		"pkg-types": "^2.3.0",
+		"semver": "^7.7.4",
+		"std-env": "^3.10.0"
+	},
+	"devDependencies": {
+		"@types/clipboardy": "^2.0.4",
+		"@types/node": "^25.2.1",
+		"@types/semver": "^7.7.1",
+		"tsdown": "^0.20.3",
+		"typescript": "^5.9.3"
+	}
+}