cli-argv-util 1.5.1 → 1.5.3

package/README.md

@@ -84,17 +84,14 @@ See the **TypeScript Declarations** at the top of [cli-argv-util.ts](src/cli-arg
 <br>
 
 ---
-**CLI Build Tools for package.json**
-   - 🎋 [add-dist-header](https://github.com/center-key/add-dist-header):&nbsp; _Prepend a one-line banner comment (with license notice) to distribution files_
-   - 📄 [cli-argv-util](https://github.com/center-key/cli-argv-util):&nbsp; _Copy or rename a file with optional package version number_
-   - 📂 [copy-folder-util](https://github.com/center-key/copy-folder-util):&nbsp; _Recursively copy files from one folder to another folder_
-   - 🪺 [recursive-exec](https://github.com/center-key/recursive-exec):&nbsp; _Run a command on each file in a folder and its subfolders_
-   - 🔍 [replacer-util](https://github.com/center-key/replacer-util):&nbsp; _Find and replace strings or template outputs in text files_
-   - 🔢 [rev-web-assets](https://github.com/center-key/rev-web-assets):&nbsp; _Revision web asset filenames with cache busting content hash fingerprints_
-   - 🚆 [run-scripts-util](https://github.com/center-key/run-scripts-util):&nbsp; _Organize npm package.json scripts into groups of easy to manage commands_
-   - 🚦 [w3c-html-validator](https://github.com/center-key/w3c-html-validator):&nbsp; _Check the markup validity of HTML files using the W3C validator_
-
-Feel free to submit questions at:<br>
-[github.com/center-key/cli-argv-util/issues](https://github.com/center-key/cli-argv-util/issues)
-
 [MIT License](LICENSE.txt)
+
+See the `runScriptsConfig` section of [`package.json`](package.json) for a clean way to organize build tasks:
+   - 🎋 [`add-dist-header`](https://github.com/center-key/add-dist-header) &mdash;&nbsp; _Prepend a one-line banner comment (with license notice) to distribution files_
+   - 📄 [`copy-file-util`](https://github.com/center-key/copy-file-util) &mdash;&nbsp; _Copy or rename a file with optional package version number_
+   - 📂 [`copy-folder-util`](https://github.com/center-key/copy-folder-util) &mdash;&nbsp; _Recursively copy files from one folder to another folder_
+   - 🪺 [`recursive-exec`](https://github.com/center-key/recursive-exec) &mdash;&nbsp; _Run a command on each file in a folder and its subfolders_
+   - 🔍 [`replacer-util`](https://github.com/center-key/replacer-util) &mdash;&nbsp; _Find and replace strings or template outputs in text files_
+   - 🔢 [`rev-web-assets`](https://github.com/center-key/rev-web-assets) &mdash;&nbsp; _Revision web asset filenames with cache busting content hash fingerprints_
+   - 🚆 [`run-scripts-util`](https://github.com/center-key/run-scripts-util) &mdash;&nbsp; _Organize npm package.json scripts into groups of easy-to-manage commands_
+   - 🚦 [`w3c-html-validator`](https://github.com/center-key/w3c-html-validator) &mdash;&nbsp; _Check the markup validity of HTML files using the W3C validator_

package/dist/cli-argv-util.d.ts

@@ -1,4 +1,4 @@
-//! cli-argv-util v1.5.1 ~~ https://github.com/center-key/cli-argv-util ~~ MIT License
+//! cli-argv-util v1.5.3 ~~ https://github.com/center-key/cli-argv-util ~~ MIT License
 
 export type StringFlagMap = {
     [flag: string]: string | undefined;
@@ -12,7 +12,14 @@ export type Ancestor = {
     target: string;
     renamed: boolean;
     filename: string | null;
+    output: string;
     message: string;
+    color: {
+        common: string;
+        source: string;
+        arrow: string;
+        target: string;
+    };
 };
 export type Result = {
     flagMap: StringFlagMap;
@@ -28,7 +35,8 @@ type JsonObject = {
     [key: string]: Json;
 };
 declare const cliArgvUtil: {
-    assert(ok: unknown, message: string | null): void;
+    version: string;
+    assertOk(ok: unknown, message: string | null): void;
     readPackageJson(): JsonObject;
     escapers: {
         regex: RegExp;
@@ -41,6 +49,7 @@ declare const cliArgvUtil: {
     }, posix: string): NonSharedBuffer;
     readFolder(folder: string): string[];
     cleanPath(name: string): string;
+    colorizePath(pathname: string): string;
     calcAncestor(sourceFile: string, targetFile: string): Ancestor;
     unquoteArgs(args: string[]): string[];
 };

package/dist/cli-argv-util.js

@@ -1,12 +1,13 @@
-//! cli-argv-util v1.5.1 ~~ https://github.com/center-key/cli-argv-util ~~ MIT License
+//! cli-argv-util v1.5.3 ~~ https://github.com/center-key/cli-argv-util ~~ MIT License
 
 import { execSync } from 'node:child_process';
 import chalk from 'chalk';
-import fs from 'fs';
-import path from 'path';
+import fs from 'node:fs';
+import path from 'node:path';
 import slash from 'slash';
 const cliArgvUtil = {
-    assert(ok, message) {
+    version: '1.5.3',
+    assertOk(ok, message) {
         if (!ok)
             throw new Error(`[replacer-util] ${message}`);
     },
@@ -51,7 +52,7 @@ const cliArgvUtil = {
         const macroValue = macros[macroName];
         const expandedText = macroName ? macroValue : text;
         const missing = macroName && !macroValue;
-        cliArgvUtil.assert(!missing, `Macro "${macroName}" used but not defined in package.json`);
+        cliArgvUtil.assertOk(!missing, `Macro "${macroName}" used but not defined in package.json`);
         const replace = (flagValue, escaper) => flagValue.replace(escaper.regex, escaper.char);
         return cliArgvUtil.escapers.reduce(replace, expandedText);
     },
@@ -93,6 +94,9 @@ const cliArgvUtil = {
     cleanPath(name) {
         return slash(path.normalize(name)).trim().replace(/\/$/, '');
     },
+    colorizePath(pathname) {
+        return chalk.green(path.dirname(pathname) + '/') + chalk.white(path.basename(pathname));
+    },
     calcAncestor(sourceFile, targetFile) {
         const index = Array.from(sourceFile).findIndex((char, i) => targetFile[i] !== char);
         const substr = index === -1 ? sourceFile : sourceFile.substring(0, index);
@@ -100,13 +104,19 @@ const cliArgvUtil = {
         const len = common.length ? common.length + 1 : 0;
         const source = sourceFile.substring(len);
         const target = targetFile.substring(len);
-        const intro = common ? chalk.blue(common) + chalk.gray.bold(': ') : '';
         const renamed = path.basename(sourceFile) !== path.basename(targetFile);
         const filename = renamed ? null : path.basename(sourceFile);
         const folder = path.dirname(target);
         const dest = renamed ? target : (folder === '.' ? filename : folder + '/');
-        const message = intro + chalk.white(source) + chalk.gray.bold(' → ') + chalk.green(dest);
-        return { common, source, target, renamed, filename, message };
+        const color = {
+            common: common ? chalk.blue(common) + chalk.gray.bold(': ') : '',
+            source: chalk.white(source),
+            arrow: chalk.gray.bold('→'),
+            target: chalk.green(dest),
+        };
+        const output = `${color.source} ${color.arrow} ${color.target}`;
+        const message = color.common + output;
+        return { common, source, target, renamed, filename, output, message, color };
     },
     unquoteArgs(args) {
         const unquote = (builder, nextArg) => {

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "cli-argv-util",
-   "version": "1.5.1",
+   "version": "1.5.3",
    "description": "Simple utility to parse command line parameters and flags (arguments vector)",
    "license": "MIT",
    "type": "module",
@@ -64,16 +64,16 @@
    },
    "devDependencies": {
       "@eslint/js": "~10.0",
-      "@types/node": "~25.5",
+      "@types/node": "~26.0",
       "add-dist-header": "~1.6",
       "assert-deep-strict-equal": "~1.2",
       "copy-file-util": "~1.3",
-      "eslint": "~10.1",
+      "eslint": "~10.6",
       "jshint": "~2.13",
       "mocha": "~11.7",
       "rimraf": "~6.1",
       "run-scripts-util": "~1.3",
-      "typescript": "~5.9",
-      "typescript-eslint": "~8.57"
+      "typescript": "~6.0",
+      "typescript-eslint": "~8.62"
    }
 }