copy-folder-util 1.1.5 → 1.1.7

package/README.md

@@ -54,7 +54,7 @@ Command-line flags:
 | `--quiet`    | Suppress informational messages.                      | N/A        |
 | `--summary`  | Only print out the single line summary message.       | N/A        |
 
-Examples:
+### 4. Examples
    - `copy-folder build --basename=index dist` <br>
    Only copies files with filenames matching `index.*`.
 
@@ -81,7 +81,7 @@ import { copyFolder } from 'copy-folder-util';
 
 const options = { fileExtensions: ['.html', '.js'] };
 const results = copyFolder.cp('src/web', 'docs/api-manual', options);
-console.log('Number of files copied:', results.count);
+console.info('Number of files copied:', results.count);
 ```
 
 See the **TypeScript Declarations** at the top of [copy-folder.ts](src/copy-folder.ts) for documentation.

package/bin/cli.js

@@ -24,7 +24,7 @@
 import { cliArgvUtil } from 'cli-argv-util';
 import { copyFolder } from '../dist/copy-folder.js';
 
-// Parameters and flags
+// Parameters and Flags
 const validFlags = ['cd', 'ext', 'note', 'quiet', 'summary'];
 const cli =        cliArgvUtil.parse(validFlags);
 const source =     cli.params[0];
@@ -32,10 +32,10 @@ const target =     cli.params[1];
 
 // Copy Folder
 const error =
-   cli.invalidFlag ?     cli.invalidFlagMsg :
-   !source ?             'Missing source folder.' :
-   !target ?             'Missing target folder.' :
-   cli.paramsCount > 2 ? 'Extraneous parameter: ' + cli.params[2] :
+   cli.invalidFlag ?    cli.invalidFlagMsg :
+   !source ?            'Missing source folder.' :
+   !target ?            'Missing target folder.' :
+   cli.paramCount > 2 ? 'Extraneous parameter: ' + cli.params[2] :
    null;
 if (error)
    throw new Error('[copy-folder-util] ' + error);

package/dist/copy-folder.d.ts

@@ -1,8 +1,8 @@
-//! copy-folder-util v1.1.5 ~~ https://github.com/center-key/copy-folder-util ~~ MIT License
+//! copy-folder-util v1.1.7 ~~ https://github.com/center-key/copy-folder-util ~~ MIT License
 
 export type Settings = {
-    basename: string;
-    cd: string;
+    basename: string | null;
+    cd: string | null;
     fileExtensions: string[];
 };
 export type Results = {
@@ -19,6 +19,11 @@ export type ReporterSettings = {
     summaryOnly: boolean;
 };
 declare const copyFolder: {
+    extraneous: {
+        files: string[];
+        folders: string[];
+    };
+    assert(ok: unknown, message: string | null): void;
     cp(sourceFolder: string, targetFolder: string, options?: Partial<Settings>): Results;
     reporter(results: Results, options?: Partial<ReporterSettings>): Results;
 };

package/dist/copy-folder.js

@@ -1,13 +1,19 @@
-//! copy-folder-util v1.1.5 ~~ https://github.com/center-key/copy-folder-util ~~ MIT License
+//! copy-folder-util v1.1.7 ~~ https://github.com/center-key/copy-folder-util ~~ MIT License
 
 import chalk from 'chalk';
 import fs from 'fs';
 import log from 'fancy-log';
 import path from 'path';
 import slash from 'slash';
-const extraneousFiles = ['.DS_Store', 'Thumbs.db', 'desktop.ini'];
-const extraneousFolders = ['.git', 'node_modules'];
 const copyFolder = {
+    extraneous: {
+        files: ['.DS_Store', 'Thumbs.db', 'desktop.ini'],
+        folders: ['.git', 'node_modules'],
+    },
+    assert(ok, message) {
+        if (!ok)
+            throw new Error(`[copy-folder-util] ${message}`);
+    },
     cp(sourceFolder, targetFolder, options) {
         const defaults = {
             basename: null,
@@ -16,21 +22,20 @@ const copyFolder = {
         };
         const settings = { ...defaults, ...options };
         const startTime = Date.now();
-        const normalize = (folder) => !folder ? '' : slash(path.normalize(folder)).replace(/\/$/, '');
-        const startFolder = settings.cd ? normalize(settings.cd) + '/' : '';
-        const source = normalize(startFolder + sourceFolder);
-        const target = normalize(startFolder + targetFolder);
+        const cleanPath = (folder) => !folder ? '' : slash(path.normalize(folder)).replace(/\/$/, '');
+        const startFolder = settings.cd ? cleanPath(settings.cd) + '/' : '';
+        const source = cleanPath(startFolder + sourceFolder);
+        const target = cleanPath(startFolder + targetFolder);
         if (targetFolder)
             fs.mkdirSync(target, { recursive: true });
-        const errorMessage = !sourceFolder ? 'Must specify the source folder path.' :
+        const error = !sourceFolder ? 'Must specify the source folder path.' :
             !targetFolder ? 'Must specify the target folder path.' :
                 !fs.existsSync(source) ? 'Source folder does not exist: ' + source :
                     !fs.existsSync(target) ? 'Target folder cannot be created: ' + target :
                         !fs.statSync(source).isDirectory() ? 'Source is not a folder: ' + source :
                             !fs.statSync(target).isDirectory() ? 'Target is not a folder: ' + target :
                                 null;
-        if (errorMessage)
-            throw new Error('[copy-folder-util] ' + errorMessage);
+        copyFolder.assert(!error, error);
         const filterOff = {
             base: !settings.basename,
             ext: !Array.isArray(settings.fileExtensions) || !settings.fileExtensions.length,
@@ -42,11 +47,11 @@ const copyFolder = {
             const isFile = fs.statSync(origin).isFile();
             const name = path.basename(origin);
             const ext = path.extname(origin);
-            const keepFolder = !isFile && !extraneousFolders.includes(name);
+            const keepFolder = !isFile && !copyFolder.extraneous.folders.includes(name);
             const keepFile = isFile &&
                 (filterOff.base || name.replace(/[.].*/, '') === settings.basename) &&
                 (filterOff.ext || settings.fileExtensions.includes(ext)) &&
-                !extraneousFiles.includes(name);
+                !copyFolder.extraneous.files.includes(name);
             if (keepFile)
                 files.push({
                     origin: relativePath(posixPath(origin), source),

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "copy-folder-util",
-   "version": "1.1.5",
+   "version": "1.1.7",
    "description": "Recursively copy files from one folder to another folder (CLI tool designed for use in npm package.json scripts)",
    "license": "MIT",
    "type": "module",
@@ -45,7 +45,7 @@
    },
    "runScriptsConfig": {
       "clean": [
-         "rimraf build dist spec/fixtures/target"
+         "rimraf build dist spec/target"
       ],
       "lint": [
          "jshint . --exclude-path .gitignore",
@@ -61,24 +61,24 @@
       "test": "mocha spec/*.spec.js"
    },
    "dependencies": {
-      "chalk": "~5.4",
-      "cli-argv-util": "~1.2",
+      "chalk": "~5.6",
+      "cli-argv-util": "~1.3",
       "fancy-log": "~2.0",
       "slash": "~5.1"
    },
    "devDependencies": {
-      "@eslint/js": "~9.21",
+      "@eslint/js": "~9.39",
       "@types/fancy-log": "~2.0",
-      "@types/node": "~22.13",
-      "add-dist-header": "~1.4",
+      "@types/node": "~24.10",
+      "add-dist-header": "~1.6",
       "assert-deep-strict-equal": "~1.2",
-      "copy-file-util": "~1.2",
-      "eslint": "~9.21",
+      "copy-file-util": "~1.3",
+      "eslint": "~9.39",
       "jshint": "~2.13",
-      "mocha": "~11.1",
-      "rimraf": "~6.0",
+      "mocha": "~11.7",
+      "rimraf": "~6.1",
       "run-scripts-util": "~1.3",
-      "typescript": "~5.8",
-      "typescript-eslint": "~8.26"
+      "typescript": "~5.9",
+      "typescript-eslint": "~8.46"
    }
 }