importmapify 1.2.0 → 1.3.0

package/deno.json

@@ -1,7 +1,7 @@
 {
 	"$schema": "https://raw.githubusercontent.com/denoland/deno/refs/heads/main/cli/schemas/config-file.v1.json",
 	"name": "@kjanat/importmapify",
-	"version": "1.2.0",
+	"version": "1.3.0",
 	"exports": "./src/mod.ts",
 	"publish": {
 		"include": [
@@ -51,6 +51,7 @@
 	"lock": false,
 	"jsrDepsInNodeModules": false,
 	"minimumDependencyAge": {
+		"age": 0,
 		"exclude": ["jsr:@kjanat/*", "npm:@kjanat/*"]
 	}
 }

package/dist/mod.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { bold, cyan, detectHyperlinkSupport } from "ansispeck";
 import { CLIError, cli, command, flag } from "dreamcli";
 import fs, { existsSync, readFileSync } from "node:fs";
 import path, { dirname } from "node:path";
@@ -478,6 +479,12 @@ function defineConfig(options) {
 }
 //#endregion
 //#region src/cli.ts
+const EXAMPLE_TOKEN = /(?:'[^']*'|"[^"]*"|\S)+/g;
+function highlightExample(example) {
+	const tokens = example.match(EXAMPLE_TOKEN);
+	if (tokens === null) return example;
+	return tokens.map((token, index) => index === 0 ? bold(token) : token.startsWith("-") ? cyan(token) : token).join(" ");
+}
 function parseKeyValue(raw, flagName, code) {
 	const eq = raw.indexOf("=");
 	if (eq === -1) throw new CLIError(`--${flagName} expects key=value, got "${raw}"`, {
@@ -571,9 +578,9 @@ async function resolveGenerateOptions(flags) {
 const generateCommand = command("generate").description("Expand package.json subpath-pattern imports into a Deno import map.").flag("root", flag.path({
 	mustExist: true,
 	type: "directory"
-}).default(cwd()).describe("Project root containing the manifest.").alias("r")).flag("manifest", flag.string().default("package.json").describe("Manifest path, relative to root.").alias("m")).flag("out", flag.string().default(DEFAULT_OUT).describe("Output path resolved against root; relative, absolute, or file:// URL.").alias("o")).flag("import", flag.array(flag.string()).describe("Additional import entry as key=value. Repeatable.").alias("i")).flag("package", flag.array(flag.string()).describe("Package as name=target, expanded to a conformant bare and trailing-slash pair. Repeatable.").alias("p")).flag("ext", flag.array(flag.string()).describe("Restrict pattern matches to these file extensions. Repeatable.").alias("e")).flag("scope", flag.array(flag.string()).describe("Scoped import as prefix::key=value. Repeatable.").alias("s")).flag("condition", flag.array(flag.string()).describe("Condition to try when a target is a conditional object. Repeatable.").alias("c")).flag("config", flag.string().describe("Config file path; skips discovery.").alias("C")).flag("no-config", flag.boolean().describe("Skip config file discovery.")).flag("check", flag.boolean().describe("Exit 1 if the output file is stale instead of writing it.")).flag("stdout", flag.boolean().describe("Print the import map to stdout instead of writing it.")).example("importmapify --stdout", "Print the generated import map").example(`importmapify --package 'dreamcli=jsr:@kjanat/dreamcli@^3' --scope './tests/::dreamcli/testkit=jsr:@kjanat/dreamcli@^3/testkit'`, "Add global and test-scoped dependencies").example("importmapify --check", "Fail when the generated file is stale").action(async ({ flags, out }) => {
-	const { log, error, setExitCode } = out;
-	const { check, stdout } = flags;
+}).default(cwd()).describe("Project root containing the manifest.").alias("r")).flag("manifest", flag.string().default("package.json").describe("Manifest path, relative to root.").alias("m")).flag("out", flag.string().default(DEFAULT_OUT).describe("Output path resolved against root; relative, absolute, or file:// URL.").alias("o")).flag("import", flag.array(flag.string()).describe("Additional import entry as key=value. Repeatable.").alias("i")).flag("package", flag.array(flag.string()).describe("Package as name=target, expanded to a conformant bare and trailing-slash pair. Repeatable.").alias("p")).flag("ext", flag.array(flag.string()).describe("Restrict pattern matches to these file extensions. Repeatable.").alias("e")).flag("scope", flag.array(flag.string()).describe("Scoped import as prefix::key=value. Repeatable.").alias("s")).flag("condition", flag.array(flag.string()).describe("Condition to try when a target is a conditional object. Repeatable.").alias("c")).flag("config", flag.string().describe("Config file path; skips discovery.").alias("C")).flag("no-config", flag.boolean().describe("Skip config file discovery.")).flag("check", flag.boolean().describe("Exit 1 if the output file is stale instead of writing it.")).flag("stdout", flag.boolean().describe("Print the import map to stdout instead of writing it.")).flag("quiet", flag.boolean().describe("Suppress the confirmation message on stderr.").alias("q")).example(highlightExample("importmapify --stdout"), "Print the generated import map").example(highlightExample(`importmapify --package 'dreamcli=jsr:@kjanat/dreamcli@^3' --scope './tests/::dreamcli/testkit=jsr:@kjanat/dreamcli@^3/testkit'`), "Add global and test-scoped dependencies").example(highlightExample("importmapify --check"), "Fail when the generated file is stale").action(async ({ flags, out }) => {
+	const { log, warn, error, setExitCode } = out;
+	const { check, stdout, quiet } = flags;
 	if (check && stdout) throw new CLIError("--check and --stdout are mutually exclusive", {
 		code: "conflicting-flags",
 		exitCode: 2
@@ -595,10 +602,11 @@ const generateCommand = command("generate").description("Expand package.json sub
 			setExitCode(1);
 			return;
 		}
-		log(`${outPath} is up to date`);
+		if (!quiet) warn(`${outPath} is up to date`);
 		return;
 	}
-	log(`Wrote ${writeImportMap(options)}`);
+	const written = writeImportMap(options);
+	if (!quiet) warn(`Wrote ${written}`);
 });
 //#endregion
 //#region src/mod.ts
@@ -623,6 +631,12 @@ const cli$1 = cli("importmapify").manifest({
 	from: import.meta.url,
 	files: ["package.json", "deno.json"]
 }).links().default(generateCommand).completions({ as: "flag" });
-if (import.meta.main) cli$1.run();
+if (import.meta.main) cli$1.run({ help: {
+	hyperlinks: detectHyperlinkSupport(),
+	theme: (c) => ({
+		headerName: (input) => c.bold(c.underline(input)),
+		headerVersion: (input) => c.dim(c.underline(input))
+	})
+} });
 //#endregion
 export { createImportMap, defineConfig, formatImportMap, packageEntries, writeImportMap };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "importmapify",
-	"version": "1.2.0",
+	"version": "1.3.0",
 	"description": "Expand package.json subpath-pattern imports into explicit Deno import map entries.",
 	"keywords": [
 		"deno",
@@ -65,6 +65,7 @@
 		"volta:bump": "volta pin node@latest npm@11; node --version>.node-version; run bd"
 	},
 	"dependencies": {
+		"ansispeck": "^0.2.0",
 		"dreamcli": "npm:@kjanat/dreamcli@^3.0.0-rc.11"
 	},
 	"devDependencies": {