copy-file-util 1.3.3 → 1.3.5

package/LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022-2025 Individual contributors to copy-file-util
+Copyright (c) 2022-2026 Individual contributors to copy-file-util
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -49,15 +49,16 @@ You can also install **copy-file-util** globally (`--global`) and then run it an
 
 ### 4. CLI flags
 Command-line flags:
-| Flag             | Description                                      | Values     |
-| ---------------- | ------------------------------------------------ | ---------- |
-| `--cd`           | Change working directory before starting copy.   | **string** |
-| `--folder`       | Indicates the target is a folder.                | N/A        |
-| `--move`         | Delete the source file after copying it.         | N/A        |
-| `--no-overwrite` | Abort if target file already exists.             | N/A        |
-| `--note`         | Place to add a comment only for humans.          | **string** |
-| `--platform-eol` | Save target file with OS dependent line endings. | N/A        |
-| `--quiet`        | Suppress informational messages.                 | N/A        |
+| Flag               | Description                                      | Values     |
+| ------------------ | ------------------------------------------------ | ---------- |
+| `--cd`             | Change working directory before starting copy.   | **string** |
+| `--folder`         | Indicates the target is a folder.                | N/A        |
+| `--move`           | Delete the source file after copying it.         | N/A        |
+| `--no-overwrite`   | Abort if target file already exists.             | N/A        |
+| `--note`           | Place to add a comment only for humans.          | **string** |
+| `--platform-eol`   | Save target file with OS dependent line endings. | N/A        |
+| `--quiet`          | Suppress informational messages.                 | N/A        |
+| `--remove-sem-ver` | Deletes text like 'v1.2.3' to avoid noisy diffs. | N/A        |
 
 ### 5. Examples
    - `copy-file app.js app.mjs --quiet`<br>
@@ -82,12 +83,17 @@ Command-line flags:
 > [!NOTE]
 > _Single quotes in commands are normalized so they work cross-platform and avoid the errors often encountered on Microsoft Windows._
 
+> [!NOTE]
+> _To copy multiple files consider using_ [copy-folder-util](https://github.com/center-key/copy-folder-util).&nbsp;
+> _It supports commands like the following to copy all **.jpg** files from one folder to another folder:<br>_
+> `copy-folder src/website --ext=.jpg docs`
+
 ### 6. Template variables
 The *target* parameter can contain template variables, like `{{package.version}}` and `{{package.name}}`, which will be replaced with values with values from your project's **package.json** file.
 
 Example:
-   - `copy-file build/app.js dist/app-v{{package.version}}.js`<br>
-   Creates a copy of **app.js** named something like **app-v1.2.3.js** based on the version of your project.
+   - `copy-file build/my-app.js dist/my-app-v{{package.version}}.js`<br>
+   Creates a copy of **my-app.js** named something like **my-app-v1.2.3.js** based on the version of your project.
 
 ## C) Application Code
 Even though **copy-file-util** is primarily intended for build scripts, the package can be used programmatically in ESM and TypeScript projects.
@@ -105,17 +111,16 @@ See the **TypeScript Declarations** at the top of [copy-file.ts](src/copy-file.t
 <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_
-   - 📄 [copy-file-util](https://github.com/center-key/copy-file-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/copy-file-util/issues](https://github.com/center-key/copy-file-util/issues)
-
 [MIT License](LICENSE.txt)
+
+[🛡️ npm Security Aggregator](https://center-key.github.io/npm-security-aggregator/?package=copy-file-util)
+
+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/copy-file.d.ts

@@ -1,4 +1,4 @@
-//! copy-file-util v1.3.3 ~~ https://github.com/center-key/copy-file-util ~~ MIT License
+//! copy-file-util v1.3.5 ~~ https://github.com/center-key/copy-file-util ~~ MIT License
 
 export type Settings = {
     cd: string | null;
@@ -8,6 +8,7 @@ export type Settings = {
     move: boolean;
     overwrite: boolean;
     platformEol: boolean;
+    removeSemVer: boolean;
 };
 export type Result = {
     origin: string;

package/dist/copy-file.js

@@ -1,12 +1,12 @@
-//! copy-file-util v1.3.3 ~~ https://github.com/center-key/copy-file-util ~~ MIT License
+//! copy-file-util v1.3.5 ~~ https://github.com/center-key/copy-file-util ~~ MIT License
 
 import { cliArgvUtil } from 'cli-argv-util';
-import { dna } from 'dna-engine';
-import { EOL } from 'node:os';
+import { dna } from 'dna-dom';
 import chalk from 'chalk';
-import fs from 'fs';
+import fs from 'node:fs';
 import log from 'fancy-log';
-import path from 'path';
+import os from 'node:os';
+import path from 'node:path';
 import slash from 'slash';
 const copyFile = {
     assert(ok, message) {
@@ -14,7 +14,8 @@ const copyFile = {
             throw new Error(`[copy-file-util] ${message}`);
     },
     cli() {
-        const validFlags = ['cd', 'folder', 'move', 'no-overwrite', 'note', 'platform-eol', 'quiet'];
+        const validFlags = ['cd', 'folder', 'move', 'no-overwrite', 'note', 'platform-eol',
+            'quiet', 'remove-sem-ver'];
         const cli = cliArgvUtil.parse(validFlags);
         const source = cli.params[0];
         const target = cli.params[1];
@@ -40,6 +41,7 @@ const copyFile = {
             move: !!cli.flagOn.move,
             overwrite: !cli.flagOn.noOverwrite,
             platformEol: !!cli.flagOn.platformEol,
+            removeSemVer: !!cli.flagOn.removeSemVer,
         };
         const result = copyFile.cp(source, options);
         if (!cli.flagOn.quiet)
@@ -54,6 +56,7 @@ const copyFile = {
             move: false,
             overwrite: true,
             platformEol: false,
+            removeSemVer: false,
         };
         const settings = { ...defaults, ...options };
         const startTime = Date.now();
@@ -84,14 +87,21 @@ const copyFile = {
                                 badTargetFolder ? 'Target folder cannot be written to: ' + String(targetFolder) :
                                     null;
         copyFile.assert(!error, error);
+        const rewriteTarget = () => {
+            const semVer = /\s+v[0-9]+\.[0-9]+\.[0-9]+\s+/;
+            const content1 = fs.readFileSync(target, 'utf-8');
+            const content2 = settings.platformEol ? content1.replace(/\r?\n/g, os.EOL) : content1;
+            const content3 = settings.removeSemVer ? content2.replace(semVer, ' ') : content2;
+            if (content1 !== content3)
+                fs.writeFileSync(target, content3);
+        };
         const createTarget = () => {
             if (settings.move)
                 fs.renameSync(source, target);
             else
                 fs.copyFileSync(source, target);
-            const platformEol = (text) => text.replace(/\r?\n/g, EOL);
-            if (settings.platformEol)
-                fs.writeFileSync(target, platformEol(fs.readFileSync(target, 'utf-8')));
+            if (settings.platformEol || settings.removeSemVer)
+                rewriteTarget();
         };
         if (!skip)
             createTarget();

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "copy-file-util",
-   "version": "1.3.3",
+   "version": "1.3.5",
    "description": "Copy or rename a file with optional package version number (CLI tool designed for use in npm package.json scripts)",
    "license": "MIT",
    "type": "module",
@@ -59,23 +59,23 @@
    },
    "dependencies": {
       "chalk": "~5.6",
-      "cli-argv-util": "~1.4",
-      "dna-engine": "~3.3",
+      "cli-argv-util": "~1.5",
+      "dna-dom": "~3.3",
       "fancy-log": "~2.0",
       "slash": "~5.1"
    },
    "devDependencies": {
-      "@eslint/js": "~9.39",
+      "@eslint/js": "~10.0",
       "@types/fancy-log": "~2.0",
-      "@types/node": "~25.0",
+      "@types/node": "~25.9",
       "add-dist-header": "~1.6",
       "assert-deep-strict-equal": "~1.2",
-      "eslint": "~9.39",
+      "eslint": "~10.4",
       "jshint": "~2.13",
       "mocha": "~11.7",
       "rimraf": "~6.1",
       "run-scripts-util": "~1.3",
-      "typescript": "~5.9",
-      "typescript-eslint": "~8.50"
+      "typescript": "~6.0",
+      "typescript-eslint": "~8.60"
    }
 }