make-folder-txt 2.2.6 → 2.2.7

package/bin/make-folder-txt.js

@@ -87,6 +87,7 @@ function collectFiles(
     rootName = "",
     txtIgnore = new Set(),
     force = false,
+    rootOnlyInclude = false,
   } = options;
 
   let entries;
@@ -129,27 +130,36 @@ 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;
+      const shouldIncludeDir = !hasOnlyFilters || (rootOnlyInclude ? false : child.hasIncluded) || explicitlySelectedFolder;
 
       if (shouldIncludeDir) {
         lines.push(`${indent}${connector}${entry.name}/`);
@@ -170,7 +180,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 +831,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 +924,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 +955,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;
       }
 
@@ -1006,9 +1033,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 +1064,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 +1113,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
       }
     );
 

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
@@ -110,6 +109,7 @@ function collectFiles(
     rootName = "",
     txtIgnore = new Set(),
     force = false,
+    rootOnlyInclude = false,
   } = options;
 
   let entries;
@@ -152,27 +152,36 @@ 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;
+      const shouldIncludeDir = !hasOnlyFilters || (rootOnlyInclude ? false : child.hasIncluded) || explicitlySelectedFolder;
 
       if (shouldIncludeDir) {
         lines.push(`${indent}${connector}${entry.name}/`);
@@ -193,7 +202,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 +853,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 +946,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 +977,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 +1055,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 +1086,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 +1135,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 +1249,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.7",
   "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": {