make-folder-txt 2.2.6 → 2.2.9

package/bin/make-folder-txt.js

@@ -87,6 +87,7 @@ function collectFiles(
     rootName = "",
     txtIgnore = new Set(),
     force = false,
+    rootOnlyInclude = false,
   } = options;
 
   let entries;
@@ -126,30 +127,46 @@ function collectFiles(
       }
 
       const childPath = path.join(dir, entry.name);
-      const childInSelectedFolder = inSelectedFolder || onlyFolders.has(entry.name);
+      // When rootOnlyInclude is active, a folder only "counts" if it's directly under root
+      const folderIsSelected = rootOnlyInclude
+        ? (dir === rootDir && onlyFolders.has(entry.name))
+        : onlyFolders.has(entry.name);
+
+      const childInSelectedFolder = inSelectedFolder || folderIsSelected;
       const childLines = [];
       const childFiles = [];
-      const child = collectFiles(
-        childPath,
-        rootDir,
-        ignoreDirs,
-        ignoreFiles,
-        onlyFolders,
-        onlyFiles,
-        {
-          indent: childIndent,
-          lines: childLines,
-          filePaths: childFiles,
-          inSelectedFolder: childInSelectedFolder,
-          hasOnlyFilters,
-          rootName,
-          txtIgnore,
-          force,
-        },
-      );
+      
+      // If rootOnlyInclude is true, skip recursing into non-selected subdirectories
+      let child;
+      if (rootOnlyInclude && dir !== rootDir && !inSelectedFolder) {
+        // Don't recurse unless already inside a selected folder
+        child = { lines: [], filePaths: [], hasIncluded: false };
+      } else {
+        child = collectFiles(
+          childPath,
+          rootDir,
+          ignoreDirs,
+          ignoreFiles,
+          onlyFolders,
+          onlyFiles,
+          {
+            indent: childIndent,
+            lines: childLines,
+            filePaths: childFiles,
+            inSelectedFolder: childInSelectedFolder,
+            hasOnlyFilters,
+            rootName,
+            txtIgnore,
+            force,
+            rootOnlyInclude,
+          },
+        );
+      }
 
-      const explicitlySelectedFolder = hasOnlyFilters && onlyFolders.has(entry.name);
-      const shouldIncludeDir = !hasOnlyFilters || child.hasIncluded || explicitlySelectedFolder;
+      // Include the dir if: no filters active, or it's explicitly selected, or (non-root-only) a child matched
+      const shouldIncludeDir = !hasOnlyFilters || 
+        folderIsSelected || 
+        (!rootOnlyInclude && child.hasIncluded);
 
       if (shouldIncludeDir) {
         lines.push(`${indent}${connector}${entry.name}/`);
@@ -170,7 +187,12 @@ function collectFiles(
       // Ignore .txt files that match the folder name (e.g., foldername.txt) unless force is enabled
       if (!force && entry.name.endsWith('.txt') && entry.name === `${rootName}.txt`) return;
 
-      const shouldIncludeFile = !hasOnlyFilters || inSelectedFolder || onlyFiles.has(entry.name);
+      // Check if this file matches any of the onlyFiles patterns
+      const shouldIncludeFile = !hasOnlyFilters || inSelectedFolder || 
+        onlyFiles.has(entry.name) || 
+        onlyFiles.has(relPathForIgnore) || 
+        onlyFiles.has(`/${relPathForIgnore}`);
+      
       if (!shouldIncludeFile) return;
 
       lines.push(`${indent}${connector}${entry.name}`);
@@ -816,6 +838,7 @@ Dump an entire project folder into a single readable .txt file.
     let noSkipFlag = false;
     let splitMethod = null; // 'folder', 'file', 'size'
     let splitSize = null; // size in bytes
+    let rootOnlyInclude = false; // For /include flag
 
     for (let i = 0; i < args.length; i += 1) {
       const arg = args[i];
@@ -908,14 +931,21 @@ Dump an entire project folder into a single readable .txt file.
       if (arg === "--ignore-folder" || arg === "-ifo") {
         let consumed = 0;
         while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
-          // Normalize the folder name: remove backslashes, trailing slashes, and leading ./
           let folderName = args[i + 1];
-          folderName = folderName.replace(/\\/g, '/'); // Convert backslashes to forward slashes
-          folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
-          folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
-          ignoreDirs.add(folderName);
-          i += 1;
-          consumed += 1;
+          
+          // Check for /folder syntax (root-only include)
+          if (folderName.startsWith("/")) {
+            const cleanFolderName = folderName.slice(1); // Remove leading /
+            onlyFolders.add(cleanFolderName);
+            rootOnlyInclude = true;
+            i += 1;
+            consumed += 1;
+          } else {
+            // Normal folder path (could be nested like folder/subfolder)
+            onlyFolders.add(folderName);
+            i += 1;
+            consumed += 1;
+          }
         }
         if (consumed === 0) {
           console.error("Error: --ignore-folder requires at least one folder name.");
@@ -932,12 +962,16 @@ Dump an entire project folder into a single readable .txt file.
           console.error("Error: --ignore-folder requires a folder name.");
           process.exit(1);
         }
-        // Normalize the folder name
-        let folderName = value;
-        folderName = folderName.replace(/\\/g, '/'); // Convert backslashes to forward slashes
-        folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
-        folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
-        ignoreDirs.add(folderName);
+        
+        // Check for /folder syntax (root-only include)
+        if (value.startsWith("/")) {
+          const cleanFolderName = value.slice(1); // Remove leading /
+          onlyFolders.add(cleanFolderName);
+          rootOnlyInclude = true;
+        } else {
+          // Normal folder path (could be nested like folder/subfolder)
+          onlyFolders.add(value);
+        }
         continue;
       }
 
@@ -970,9 +1004,12 @@ Dump an entire project folder into a single readable .txt file.
       if (arg === "--only-folder" || arg === "-ofo") {
         let consumed = 0;
         while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
-          // Normalize the folder name
           let folderName = args[i + 1];
           folderName = folderName.replace(/\\/g, '/'); // Convert backslashes to forward slashes
+          // Detect leading / as root-only signal (same as --only-file behavior)
+          if (folderName.startsWith("/")) {
+            rootOnlyInclude = true;
+          }
           folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
           folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
           onlyFolders.add(folderName);
@@ -994,9 +1031,12 @@ Dump an entire project folder into a single readable .txt file.
           console.error("Error: --only-folder requires a folder name.");
           process.exit(1);
         }
-        // Normalize the folder name
         let folderName = value;
         folderName = folderName.replace(/\\/g, '/'); // Convert backslashes to forward slashes
+        // Detect leading / as root-only signal
+        if (folderName.startsWith("/")) {
+          rootOnlyInclude = true;
+        }
         folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
         folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
         onlyFolders.add(folderName);
@@ -1006,9 +1046,21 @@ Dump an entire project folder into a single readable .txt file.
       if (arg === "--only-file" || arg === "-ofi") {
         let consumed = 0;
         while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
-          onlyFiles.add(args[i + 1]);
-          i += 1;
-          consumed += 1;
+          let fileName = args[i + 1];
+          
+          // Check for /file syntax (root-only include)
+          if (fileName.startsWith("/")) {
+            const cleanFileName = fileName.slice(1); // Remove leading /
+            onlyFiles.add(cleanFileName);
+            rootOnlyInclude = true;
+            i += 1;
+            consumed += 1;
+          } else {
+            // Normal file path (could be nested like folder/file.ext)
+            onlyFiles.add(fileName);
+            i += 1;
+            consumed += 1;
+          }
         }
         if (consumed === 0) {
           console.error("Error: --only-file requires at least one file name.");
@@ -1025,7 +1077,16 @@ Dump an entire project folder into a single readable .txt file.
           console.error("Error: --only-file requires a file name.");
           process.exit(1);
         }
-        onlyFiles.add(value);
+        
+        // Check for /file syntax (root-only include)
+        if (value.startsWith("/")) {
+          const cleanFileName = value.slice(1); // Remove leading /
+          onlyFiles.add(cleanFileName);
+          rootOnlyInclude = true;
+        } else {
+          // Normal file path (could be nested like folder/file.ext)
+          onlyFiles.add(value);
+        }
         continue;
       }
 
@@ -1065,7 +1126,8 @@ Dump an entire project folder into a single readable .txt file.
         rootName, 
         txtIgnore, 
         force: forceFlag,
-        hasOnlyFilters: onlyFolders.size > 0 || onlyFiles.size > 0
+        hasOnlyFilters: onlyFolders.size > 0 || onlyFiles.size > 0,
+        rootOnlyInclude
       }
     );
 
@@ -1175,4 +1237,4 @@ Dump an entire project folder into a single readable .txt file.
 main().catch(err => {
   console.error('❌ Error:', err.message);
   process.exit(1);
-});
+});

package/make-folder-txt.txt

@@ -10,9 +10,8 @@ Root: C:\Programming\make-folder-txt
 make-folder-txt/
 ├── bin/
 │   └── make-folder-txt.js
-├── package.json
 
-Total files: 2
+Total files: 1
 
 ================================================================================
 FILE CONTENTS
@@ -21,7 +20,7 @@ FILE CONTENTS
 --------------------------------------------------------------------------------
 FILE: /bin/make-folder-txt.js
 --------------------------------------------------------------------------------
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 const fs = require("fs");
 const path = require("path");
@@ -110,6 +109,7 @@ function collectFiles(
     rootName = "",
     txtIgnore = new Set(),
     force = false,
+    rootOnlyInclude = false,
   } = options;
 
   let entries;
@@ -152,27 +152,40 @@ function collectFiles(
       const childInSelectedFolder = inSelectedFolder || onlyFolders.has(entry.name);
       const childLines = [];
       const childFiles = [];
-      const child = collectFiles(
-        childPath,
-        rootDir,
-        ignoreDirs,
-        ignoreFiles,
-        onlyFolders,
-        onlyFiles,
-        {
-          indent: childIndent,
-          lines: childLines,
-          filePaths: childFiles,
-          inSelectedFolder: childInSelectedFolder,
-          hasOnlyFilters,
-          rootName,
-          txtIgnore,
-          force,
-        },
-      );
+      
+      // If rootOnlyInclude is true, only include root-level items
+      let child;
+      if (rootOnlyInclude && dir !== rootDir) {
+        // Don't recurse into subdirectories when rootOnlyInclude is true
+        child = { lines: [], filePaths: [], hasIncluded: false };
+      } else {
+        child = collectFiles(
+          childPath,
+          rootDir,
+          ignoreDirs,
+          ignoreFiles,
+          onlyFolders,
+          onlyFiles,
+          {
+            indent: childIndent,
+            lines: childLines,
+            filePaths: childFiles,
+            inSelectedFolder: childInSelectedFolder,
+            hasOnlyFilters,
+            rootName,
+            txtIgnore,
+            force,
+            rootOnlyInclude,
+          },
+        );
+      }
 
       const explicitlySelectedFolder = hasOnlyFilters && onlyFolders.has(entry.name);
-      const shouldIncludeDir = !hasOnlyFilters || child.hasIncluded || explicitlySelectedFolder;
+      // For root-only include, only include if we're at the root level and it matches
+      const shouldIncludeDir = !hasOnlyFilters || 
+        (rootOnlyInclude && dir === rootDir && onlyFolders.has(entry.name)) || 
+        (!rootOnlyInclude && child.hasIncluded) || 
+        explicitlySelectedFolder;
 
       if (shouldIncludeDir) {
         lines.push(`${indent}${connector}${entry.name}/`);
@@ -193,7 +206,12 @@ function collectFiles(
       // Ignore .txt files that match the folder name (e.g., foldername.txt) unless force is enabled
       if (!force && entry.name.endsWith('.txt') && entry.name === `${rootName}.txt`) return;
 
-      const shouldIncludeFile = !hasOnlyFilters || inSelectedFolder || onlyFiles.has(entry.name);
+      // Check if this file matches any of the onlyFiles patterns
+      const shouldIncludeFile = !hasOnlyFilters || inSelectedFolder || 
+        onlyFiles.has(entry.name) || 
+        onlyFiles.has(relPathForIgnore) || 
+        onlyFiles.has(`/${relPathForIgnore}`);
+      
       if (!shouldIncludeFile) return;
 
       lines.push(`${indent}${connector}${entry.name}`);
@@ -839,6 +857,7 @@ Dump an entire project folder into a single readable .txt file.
     let noSkipFlag = false;
     let splitMethod = null; // 'folder', 'file', 'size'
     let splitSize = null; // size in bytes
+    let rootOnlyInclude = false; // For /include flag
 
     for (let i = 0; i < args.length; i += 1) {
       const arg = args[i];
@@ -931,14 +950,21 @@ Dump an entire project folder into a single readable .txt file.
       if (arg === "--ignore-folder" || arg === "-ifo") {
         let consumed = 0;
         while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
-          // Normalize the folder name: remove backslashes, trailing slashes, and leading ./
           let folderName = args[i + 1];
-          folderName = folderName.replace(/\\/g, '/'); // Convert backslashes to forward slashes
-          folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
-          folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
-          ignoreDirs.add(folderName);
-          i += 1;
-          consumed += 1;
+          
+          // Check for /folder syntax (root-only include)
+          if (folderName.startsWith("/")) {
+            const cleanFolderName = folderName.slice(1); // Remove leading /
+            onlyFolders.add(cleanFolderName);
+            rootOnlyInclude = true;
+            i += 1;
+            consumed += 1;
+          } else {
+            // Normal folder path (could be nested like folder/subfolder)
+            onlyFolders.add(folderName);
+            i += 1;
+            consumed += 1;
+          }
         }
         if (consumed === 0) {
           console.error("Error: --ignore-folder requires at least one folder name.");
@@ -955,12 +981,16 @@ Dump an entire project folder into a single readable .txt file.
           console.error("Error: --ignore-folder requires a folder name.");
           process.exit(1);
         }
-        // Normalize the folder name
-        let folderName = value;
-        folderName = folderName.replace(/\\/g, '/'); // Convert backslashes to forward slashes
-        folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
-        folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
-        ignoreDirs.add(folderName);
+        
+        // Check for /folder syntax (root-only include)
+        if (value.startsWith("/")) {
+          const cleanFolderName = value.slice(1); // Remove leading /
+          onlyFolders.add(cleanFolderName);
+          rootOnlyInclude = true;
+        } else {
+          // Normal folder path (could be nested like folder/subfolder)
+          onlyFolders.add(value);
+        }
         continue;
       }
 
@@ -1029,9 +1059,21 @@ Dump an entire project folder into a single readable .txt file.
       if (arg === "--only-file" || arg === "-ofi") {
         let consumed = 0;
         while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
-          onlyFiles.add(args[i + 1]);
-          i += 1;
-          consumed += 1;
+          let fileName = args[i + 1];
+          
+          // Check for /file syntax (root-only include)
+          if (fileName.startsWith("/")) {
+            const cleanFileName = fileName.slice(1); // Remove leading /
+            onlyFiles.add(cleanFileName);
+            rootOnlyInclude = true;
+            i += 1;
+            consumed += 1;
+          } else {
+            // Normal file path (could be nested like folder/file.ext)
+            onlyFiles.add(fileName);
+            i += 1;
+            consumed += 1;
+          }
         }
         if (consumed === 0) {
           console.error("Error: --only-file requires at least one file name.");
@@ -1048,7 +1090,16 @@ Dump an entire project folder into a single readable .txt file.
           console.error("Error: --only-file requires a file name.");
           process.exit(1);
         }
-        onlyFiles.add(value);
+        
+        // Check for /file syntax (root-only include)
+        if (value.startsWith("/")) {
+          const cleanFileName = value.slice(1); // Remove leading /
+          onlyFiles.add(cleanFileName);
+          rootOnlyInclude = true;
+        } else {
+          // Normal file path (could be nested like folder/file.ext)
+          onlyFiles.add(value);
+        }
         continue;
       }
 
@@ -1088,7 +1139,8 @@ Dump an entire project folder into a single readable .txt file.
         rootName, 
         txtIgnore, 
         force: forceFlag,
-        hasOnlyFilters: onlyFolders.size > 0 || onlyFiles.size > 0
+        hasOnlyFilters: onlyFolders.size > 0 || onlyFiles.size > 0,
+        rootOnlyInclude
       }
     );
 
@@ -1201,37 +1253,6 @@ main().catch(err => {
 });
 
 
---------------------------------------------------------------------------------
-FILE: /package.json
---------------------------------------------------------------------------------
-{
-  "name": "make-folder-txt",
-  "version": "2.2.5",
-  "description": "Generate a single .txt file containing the full folder structure and file contents of any project, ignoring node_modules and other junk.",
-  "main": "bin/make-folder-txt.js",
-  "bin": {
-    "make-folder-txt": "bin/make-folder-txt.js"
-  },
-  "scripts": {
-    "test": "echo \"No tests yet\" && exit 0"
-  },
-  "keywords": [
-    "folder",
-    "dump",
-    "project",
-    "structure",
-    "txt",
-    "cli",
-    "export"
-  ],
-  "author": "Muhammad Saad Amin",
-  "license": "MIT",
-  "engines": {
-    "node": ">=14.0.0"
-  }
-}
-
-
 ================================================================================
 END OF FOLDER: make-folder-txt
 ================================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "make-folder-txt",
-  "version": "2.2.6",
+  "version": "2.2.9",
   "description": "Generate a single .txt file containing the full folder structure and file contents of any project, ignoring node_modules and other junk.",
   "main": "bin/make-folder-txt.js",
   "bin": {