make-folder-txt 2.1.3 → 2.1.4

package/bin/make-folder-txt.js

@@ -617,7 +617,12 @@ for (let i = 0; i < args.length; i += 1) {
   if (arg === "--ignore-folder" || arg === "-ifo") {
     let consumed = 0;
     while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
-      ignoreDirs.add(args[i + 1]);
+      // 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;
     }
@@ -636,7 +641,12 @@ for (let i = 0; i < args.length; i += 1) {
       console.error("Error: --ignore-folder requires a folder name.");
       process.exit(1);
     }
-    ignoreDirs.add(value);
+    // 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);
     continue;
   }
 
@@ -669,7 +679,12 @@ for (let i = 0; i < args.length; i += 1) {
   if (arg === "--only-folder" || arg === "-ofo") {
     let consumed = 0;
     while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
-      onlyFolders.add(args[i + 1]);
+      // Normalize the folder name
+      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
+      onlyFolders.add(folderName);
       i += 1;
       consumed += 1;
     }
@@ -688,7 +703,12 @@ for (let i = 0; i < args.length; i += 1) {
       console.error("Error: --only-folder requires a folder name.");
       process.exit(1);
     }
-    onlyFolders.add(value);
+    // 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
+    onlyFolders.add(folderName);
     continue;
   }
 

package/make-folder-txt.txt

@@ -8,20 +8,940 @@ PROJECT STRUCTURE
 Root: C:\Programming\make-folder-txt
 
 make-folder-txt/
+├── .git/  [skipped]
+├── bin/
+│   └── make-folder-txt.js
+├── completion/  [skipped]
+├── LICENSE
 ├── package.json
+└── README.md
 
-Total files: 1
+Total files: 4
 
 ================================================================================
 FILE CONTENTS
 ================================================================================
 
+--------------------------------------------------------------------------------
+FILE: /bin/make-folder-txt.js
+--------------------------------------------------------------------------------
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const { version } = require("../package.json");
+const { execSync } = require("child_process");
+
+// ── config ────────────────────────────────────────────────────────────────────
+const IGNORE_DIRS = new Set(["node_modules", ".git", ".next", "dist", "build", ".cache"]);
+const IGNORE_FILES = new Set([".DS_Store", "Thumbs.db", "desktop.ini", ".txtignore"]);
+
+const BINARY_EXTS = new Set([
+  ".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".svg", ".webp",
+  ".pdf", ".zip", ".tar", ".gz", ".rar", ".7z",
+  ".exe", ".dll", ".so", ".dylib", ".bin",
+  ".mp3", ".mp4", ".wav", ".avi", ".mov",
+  ".woff", ".woff2", ".ttf", ".eot", ".otf",
+  ".lock",
+]);
+
+// ── helpers ───────────────────────────────────────────────────────────────────
+
+function readTxtIgnore(rootDir) {
+  const txtIgnorePath = path.join(rootDir, '.txtignore');
+  const ignorePatterns = new Set();
+  
+  try {
+    const content = fs.readFileSync(txtIgnorePath, 'utf8');
+    const lines = content.split('\n')
+      .map(line => line.trim())
+      .filter(line => line && !line.startsWith('#'));
+    
+    lines.forEach(line => ignorePatterns.add(line));
+  } catch (err) {
+    // .txtignore doesn't exist or can't be read - that's fine
+  }
+  
+  return ignorePatterns;
+}
+
+function copyToClipboard(text) {
+  try {
+    if (process.platform === 'win32') {
+      // Windows
+      execSync(`echo ${JSON.stringify(text).replace(/"/g, '""')} | clip`, { stdio: 'ignore' });
+    } else if (process.platform === 'darwin') {
+      // macOS
+      execSync(`echo ${JSON.stringify(text)} | pbcopy`, { stdio: 'ignore' });
+    } else {
+      // Linux (requires xclip or xsel)
+      try {
+        execSync(`echo ${JSON.stringify(text)} | xclip -selection clipboard`, { stdio: 'ignore' });
+      } catch {
+        try {
+          execSync(`echo ${JSON.stringify(text)} | xsel --clipboard --input`, { stdio: 'ignore' });
+        } catch {
+          console.warn('⚠️  Could not copy to clipboard. Install xclip or xsel on Linux.');
+          return false;
+        }
+      }
+    }
+    return true;
+  } catch (err) {
+    console.warn('⚠️  Could not copy to clipboard:', err.message);
+    return false;
+  }
+}
+
+function collectFiles(
+  dir,
+  rootDir,
+  ignoreDirs,
+  ignoreFiles,
+  onlyFolders,
+  onlyFiles,
+  options = {},
+) {
+  const {
+    indent = "",
+    lines = [],
+    filePaths = [],
+    inSelectedFolder = false,
+    hasOnlyFilters = false,
+    rootName = "",
+    txtIgnore = new Set(),
+    force = false,
+  } = options;
+
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return { lines, filePaths, hasIncluded: false };
+  }
+
+  entries.sort((a, b) => {
+    if (a.isDirectory() === b.isDirectory()) return a.name.localeCompare(b.name);
+    return a.isDirectory() ? -1 : 1;
+  });
+
+  entries.forEach((entry, idx) => {
+    const isLast = idx === entries.length - 1;
+    const connector = isLast ? "└── " : "├── ";
+    const childIndent = indent + (isLast ? "    " : "│   ");
+
+    if (entry.isDirectory()) {
+      if (!force && ignoreDirs.has(entry.name)) {
+        if (!hasOnlyFilters) {
+          lines.push(`${indent}${connector}${entry.name}/  [skipped]`);
+        }
+        return;
+      }
+
+      // Get relative path for .txtignore pattern matching
+      const relPathForIgnore = path.relative(rootDir, path.join(dir, entry.name)).split(path.sep).join("/");
+      
+      // Check against .txtignore patterns (both dirname and relative path) unless force is enabled
+      if (!force && (txtIgnore.has(entry.name) || txtIgnore.has(`${entry.name}/`) || txtIgnore.has(relPathForIgnore) || txtIgnore.has(`${relPathForIgnore}/`) || txtIgnore.has(`/${relPathForIgnore}/`))) {
+        if (!hasOnlyFilters) {
+          lines.push(`${indent}${connector}${entry.name}/  [skipped]`);
+        }
+        return;
+      }
+
+      const childPath = path.join(dir, entry.name);
+      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,
+        },
+      );
+
+      const explicitlySelectedFolder = hasOnlyFilters && onlyFolders.has(entry.name);
+      const shouldIncludeDir = !hasOnlyFilters || child.hasIncluded || explicitlySelectedFolder;
+
+      if (shouldIncludeDir) {
+        lines.push(`${indent}${connector}${entry.name}/`);
+        lines.push(...child.lines);
+        filePaths.push(...child.filePaths);
+      }
+    } else {
+      if (!force && ignoreFiles.has(entry.name)) return;
+
+      // Get relative path for .txtignore pattern matching
+      const relPathForIgnore = path.relative(rootDir, path.join(dir, entry.name)).split(path.sep).join("/");
+      
+      // Check against .txtignore patterns (both filename and relative path) unless force is enabled
+      if (!force && (txtIgnore.has(entry.name) || txtIgnore.has(relPathForIgnore) || txtIgnore.has(`/${relPathForIgnore}`))) {
+        return;
+      }
+
+      // 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);
+      if (!shouldIncludeFile) return;
+
+      lines.push(`${indent}${connector}${entry.name}`);
+      const relPath = "/" + path.relative(rootDir, path.join(dir, entry.name)).split(path.sep).join("/");
+      filePaths.push({ abs: path.join(dir, entry.name), rel: relPath });
+    }
+  });
+
+  return { lines, filePaths, hasIncluded: filePaths.length > 0 || lines.length > 0 };
+}
+
+function parseFileSize(sizeStr) {
+  const units = {
+    'B': 1,
+    'KB': 1024,
+    'MB': 1024 * 1024,
+    'GB': 1024 * 1024 * 1024,
+    'TB': 1024 * 1024 * 1024 * 1024
+  };
+  
+  const match = sizeStr.match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB|TB)$/i);
+  if (!match) {
+    console.error(`Error: Invalid size format "${sizeStr}". Use format like "500KB", "2MB", "1GB".`);
+    process.exit(1);
+  }
+  
+  const value = parseFloat(match[1]);
+  const unit = match[2].toUpperCase();
+  return Math.floor(value * units[unit]);
+}
+
+function readContent(absPath, force = false, maxFileSize = 500 * 1024) {
+  const ext = path.extname(absPath).toLowerCase();
+  if (!force && BINARY_EXTS.has(ext)) return "[binary / skipped]";
+  try {
+    const stat = fs.statSync(absPath);
+    if (!force && stat.size > maxFileSize) {
+      const sizeStr = stat.size < 1024 ? `${stat.size} B` : 
+                     stat.size < 1024 * 1024 ? `${(stat.size / 1024).toFixed(1)} KB` :
+                     stat.size < 1024 * 1024 * 1024 ? `${(stat.size / (1024 * 1024)).toFixed(1)} MB` :
+                     `${(stat.size / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+      return `[file too large: ${sizeStr} – skipped]`;
+    }
+    return fs.readFileSync(absPath, "utf8");
+  } catch (err) {
+    return `[could not read file: ${err.message}]`;
+  }
+}
+
+function splitByFolders(treeLines, filePaths, rootName, effectiveMaxSize, forceFlag) {
+  const folders = new Map();
+  
+  // Group files by folder
+  filePaths.forEach(({ abs, rel }) => {
+    const folderPath = path.dirname(rel);
+    const folderKey = folderPath === '/' ? rootName : folderPath.slice(1);
+    
+    if (!folders.has(folderKey)) {
+      folders.set(folderKey, []);
+    }
+    folders.get(folderKey).push({ abs, rel });
+  });
+  
+  const results = [];
+  
+  folders.forEach((files, folderName) => {
+    const out = [];
+    const divider = "=".repeat(80);
+    const subDivider = "-".repeat(80);
+    
+    out.push(divider);
+    out.push(`START OF FOLDER: ${folderName}`);
+    out.push(divider);
+    out.push("");
+    
+    // Add folder structure (only this folder's structure)
+    const folderTreeLines = treeLines.filter(line => 
+      line.includes(folderName + '/') || line === `${rootName}/`
+    );
+    
+    out.push(divider);
+    out.push("PROJECT STRUCTURE");
+    out.push(divider);
+    out.push(`Root: ${folderPath}\n`);
+    out.push(`${rootName}/`);
+    folderTreeLines.forEach(l => out.push(l));
+    out.push("");
+    out.push(`Total files in this folder: ${files.length}`);
+    out.push("");
+    
+    out.push(divider);
+    out.push("FILE CONTENTS");
+    out.push(divider);
+    
+    files.forEach(({ abs, rel }) => {
+      out.push("");
+      out.push(subDivider);
+      out.push(`FILE: ${rel}`);
+      out.push(subDivider);
+      out.push(readContent(abs, forceFlag, effectiveMaxSize));
+    });
+    
+    out.push("");
+    out.push(divider);
+    out.push(`END OF FOLDER: ${folderName}`);
+    out.push(divider);
+    
+    const fileName = `${rootName}-${folderName.replace(/[\/\\]/g, '-')}.txt`;
+    const filePath = path.join(process.cwd(), fileName);
+    
+    fs.writeFileSync(filePath, out.join("\n"), "utf8");
+    const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+    
+    results.push({
+      file: filePath,
+      size: sizeKB,
+      files: files.length,
+      folder: folderName
+    });
+  });
+  
+  return results;
+}
+
+function splitByFiles(filePaths, rootName, effectiveMaxSize, forceFlag) {
+  const results = [];
+  
+  filePaths.forEach(({ abs, rel }) => {
+    const out = [];
+    const divider = "=".repeat(80);
+    const subDivider = "-".repeat(80);
+    const fileName = path.basename(rel, path.extname(rel));
+    
+    out.push(divider);
+    out.push(`FILE: ${rel}`);
+    out.push(divider);
+    out.push("");
+    
+    out.push(divider);
+    out.push("FILE CONTENTS");
+    out.push(divider);
+    out.push(readContent(abs, forceFlag, effectiveMaxSize));
+    
+    out.push("");
+    out.push(divider);
+    out.push(`END OF FILE: ${rel}`);
+    out.push(divider);
+    
+    const outputFileName = `${rootName}-${fileName}.txt`;
+    const filePath = path.join(process.cwd(), outputFileName);
+    
+    fs.writeFileSync(filePath, out.join("\n"), "utf8");
+    const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+    
+    results.push({
+      file: filePath,
+      size: sizeKB,
+      files: 1,
+      fileName: fileName
+    });
+  });
+  
+  return results;
+}
+
+function splitBySize(treeLines, filePaths, rootName, splitSize, effectiveMaxSize, forceFlag) {
+  const results = [];
+  let currentPart = 1;
+  let currentSize = 0;
+  let currentFiles = [];
+  
+  const divider = "=".repeat(80);
+  const subDivider = "-".repeat(80);
+  
+  // Start with header
+  let out = [];
+  out.push(divider);
+  out.push(`START OF FOLDER: ${rootName} (Part ${currentPart})`);
+  out.push(divider);
+  out.push("");
+  
+  out.push(divider);
+  out.push("PROJECT STRUCTURE");
+  out.push(divider);
+  out.push(`Root: ${folderPath}\n`);
+  out.push(`${rootName}/`);
+  treeLines.forEach(l => out.push(l));
+  out.push("");
+  out.push(`Total files: ${filePaths.length}`);
+  out.push("");
+  
+  out.push(divider);
+  out.push("FILE CONTENTS");
+  out.push(divider);
+  
+  filePaths.forEach(({ abs, rel }) => {
+    const content = readContent(abs, forceFlag, effectiveMaxSize);
+    const fileContent = [
+      "",
+      subDivider,
+      `FILE: ${rel}`,
+      subDivider,
+      content
+    ];
+    
+    const contentSize = fileContent.join("\n").length;
+    
+    // Check if adding this file would exceed the split size
+    if (currentSize + contentSize > splitSize && currentFiles.length > 0) {
+      // Finish current part
+      out.push("");
+      out.push(divider);
+      out.push(`END OF FOLDER: ${rootName} (Part ${currentPart})`);
+      out.push(divider);
+      
+      // Write current part
+      const fileName = `${rootName}-part-${currentPart}.txt`;
+      const filePath = path.join(process.cwd(), fileName);
+      fs.writeFileSync(filePath, out.join("\n"), "utf8");
+      const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+      
+      results.push({
+        file: filePath,
+        size: sizeKB,
+        files: currentFiles.length,
+        part: currentPart
+      });
+      
+      // Start new part
+      currentPart++;
+      currentSize = 0;
+      currentFiles = [];
+      
+      out = [];
+      out.push(divider);
+      out.push(`START OF FOLDER: ${rootName} (Part ${currentPart})`);
+      out.push(divider);
+      out.push("");
+      
+      out.push(divider);
+      out.push("PROJECT STRUCTURE");
+      out.push(divider);
+      out.push(`Root: ${folderPath}\n`);
+      out.push(`${rootName}/`);
+      treeLines.forEach(l => out.push(l));
+      out.push("");
+      out.push(`Total files: ${filePaths.length}`);
+      out.push("");
+      
+      out.push(divider);
+      out.push("FILE CONTENTS");
+      out.push(divider);
+    }
+    
+    // Add file to current part
+    out.push(...fileContent);
+    currentSize += contentSize;
+    currentFiles.push(rel);
+  });
+  
+  // Write final part
+  out.push("");
+  out.push(divider);
+  out.push(`END OF FOLDER: ${rootName} (Part ${currentPart})`);
+  out.push(divider);
+  
+  const fileName = `${rootName}-part-${currentPart}.txt`;
+  const filePath = path.join(process.cwd(), fileName);
+  fs.writeFileSync(filePath, out.join("\n"), "utf8");
+  const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+  
+  results.push({
+    file: filePath,
+    size: sizeKB,
+    files: currentFiles.length,
+    part: currentPart
+  });
+  
+  return results;
+}
+
+// ── main ──────────────────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+
+if (args.includes("-v") || args.includes("--version")) {
+  console.log(`v${version}`);
+  console.log("Built by Muhammad Saad Amin");
+  process.exit(0);
+}
+
+if (args.includes("--help") || args.includes("-h")) {
+  console.log(` 
+\x1b[33mmake-folder-txt\x1b[0m
+Dump an entire project folder into a single readable .txt file.
+
+\x1b[33mUSAGE\x1b[0m
+  make-folder-txt [options]
+
+\x1b[33mOPTIONS\x1b[0m
+  --ignore-folder, -ifo <names...>    Ignore specific folders by name
+  --ignore-file, -ifi <names...>      Ignore specific files by name
+  --only-folder, -ofo <names...>      Include only specific folders
+  --only-file, -ofi <names...>        Include only specific files
+  --skip-large <size>                 Skip files larger than specified size (default: 500KB)
+  --no-skip                           Include all files regardless of size
+  --split-method <method>             Split output: folder, file, or size
+  --split-size <size>                 Split output when size exceeds limit (requires --split-method size)
+  --copy                              Copy output to clipboard
+  --force                             Include everything (overrides all ignore patterns)
+  --help, -h                          Show this help message
+  --version, -v                       Show version information
+
+\x1b[33mEXAMPLES\x1b[0m
+  make-folder-txt
+  make-folder-txt --copy
+  make-folder-txt --force
+  make-folder-txt --skip-large 400KB
+  make-folder-txt --skip-large 5GB
+  make-folder-txt --no-skip
+  make-folder-txt --split-method folder
+  make-folder-txt --split-method file
+  make-folder-txt --split-method size --split-size 5MB
+  make-folder-txt --ignore-folder node_modules dist
+  make-folder-txt -ifo node_modules dist
+  make-folder-txt --ignore-file .env .env.local
+  make-folder-txt -ifi .env .env.local
+  make-folder-txt --only-folder src docs
+  make-folder-txt -ofo src docs
+  make-folder-txt --only-file package.json README.md
+  make-folder-txt -ofi package.json README.md
+
+\x1b[33m.TXTIGNORE FILE\x1b[0m
+  Create a .txtignore file in your project root to specify files/folders to ignore.
+  Works like .gitignore - supports file names, path patterns, and comments.
+
+  Example .txtignore:
+    node_modules/
+    *.log
+    .env
+    coverage/
+    LICENSE
+`);
+  process.exit(0);
+}
+
+const ignoreDirs = new Set(IGNORE_DIRS);
+const ignoreFiles = new Set(IGNORE_FILES);
+const onlyFolders = new Set();
+const onlyFiles = new Set();
+let outputArg = null;
+let copyToClipboardFlag = false;
+let forceFlag = false;
+let maxFileSize = 500 * 1024; // Default 500KB
+let noSkipFlag = false;
+let splitMethod = null; // 'folder', 'file', 'size'
+let splitSize = null; // size in bytes
+
+for (let i = 0; i < args.length; i += 1) {
+  const arg = args[i];
+
+  if (arg === "--copy") {
+    copyToClipboardFlag = true;
+    continue;
+  }
+
+  if (arg === "--force") {
+    forceFlag = true;
+    continue;
+  }
+
+  if (arg === "--no-skip") {
+    noSkipFlag = true;
+    continue;
+  }
+
+  if (arg === "--skip-large") {
+    if (i + 1 >= args.length || args[i + 1].startsWith("-")) {
+      console.error("Error: --skip-large requires a size value (e.g., 400KB, 5GB).");
+      process.exit(1);
+    }
+    maxFileSize = parseFileSize(args[i + 1]);
+    i += 1;
+    continue;
+  }
+
+  if (arg.startsWith("--skip-large=")) {
+    const value = arg.slice("--skip-large=".length);
+    if (!value) {
+      console.error("Error: --skip-large requires a size value (e.g., 400KB, 5GB).");
+      process.exit(1);
+    }
+    maxFileSize = parseFileSize(value);
+    continue;
+  }
+
+  if (arg === "--split-method") {
+    if (i + 1 >= args.length || args[i + 1].startsWith("-")) {
+      console.error("Error: --split-method requires a method (folder, file, or size).");
+      process.exit(1);
+    }
+    const method = args[i + 1].toLowerCase();
+    if (!['folder', 'file', 'size'].includes(method)) {
+      console.error("Error: --split-method must be one of: folder, file, size");
+      process.exit(1);
+    }
+    splitMethod = method;
+    i += 1;
+    continue;
+  }
+
+  if (arg.startsWith("--split-method=")) {
+    const value = arg.slice("--split-method=".length);
+    if (!value) {
+      console.error("Error: --split-method requires a method (folder, file, or size).");
+      process.exit(1);
+    }
+    const method = value.toLowerCase();
+    if (!['folder', 'file', 'size'].includes(method)) {
+      console.error("Error: --split-method must be one of: folder, file, size");
+      process.exit(1);
+    }
+    splitMethod = method;
+    continue;
+  }
+
+  if (arg === "--split-size") {
+    if (i + 1 >= args.length || args[i + 1].startsWith("-")) {
+      console.error("Error: --split-size requires a size value (e.g., 5MB, 10MB).");
+      process.exit(1);
+    }
+    splitSize = parseFileSize(args[i + 1]);
+    i += 1;
+    continue;
+  }
+
+  if (arg.startsWith("--split-size=")) {
+    const value = arg.slice("--split-size=".length);
+    if (!value) {
+      console.error("Error: --split-size requires a size value (e.g., 5MB, 10MB).");
+      process.exit(1);
+    }
+    splitSize = parseFileSize(value);
+    continue;
+  }
+
+  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;
+    }
+    if (consumed === 0) {
+      console.error("Error: --ignore-folder requires at least one folder name.");
+      process.exit(1);
+    }
+    continue;
+  }
+
+  if (arg.startsWith("--ignore-folder=") || arg.startsWith("-ifo=")) {
+    const value = arg.startsWith("--ignore-folder=") 
+      ? arg.slice("--ignore-folder=".length)
+      : arg.slice("-ifo=".length);
+    if (!value) {
+      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);
+    continue;
+  }
+
+  if (arg === "--ignore-file" || arg === "-ifi") {
+    let consumed = 0;
+    while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+      ignoreFiles.add(args[i + 1]);
+      i += 1;
+      consumed += 1;
+    }
+    if (consumed === 0) {
+      console.error("Error: --ignore-file requires at least one file name.");
+      process.exit(1);
+    }
+    continue;
+  }
+
+  if (arg.startsWith("--ignore-file=") || arg.startsWith("-ifi=")) {
+    const value = arg.startsWith("--ignore-file=") 
+      ? arg.slice("--ignore-file=".length)
+      : arg.slice("-ifi=".length);
+    if (!value) {
+      console.error("Error: --ignore-file requires a file name.");
+      process.exit(1);
+    }
+    ignoreFiles.add(value);
+    continue;
+  }
+
+  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
+      folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
+      folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
+      onlyFolders.add(folderName);
+      i += 1;
+      consumed += 1;
+    }
+    if (consumed === 0) {
+      console.error("Error: --only-folder requires at least one folder name.");
+      process.exit(1);
+    }
+    continue;
+  }
+
+  if (arg.startsWith("--only-folder=") || arg.startsWith("-ofo=")) {
+    const value = arg.startsWith("--only-folder=") 
+      ? arg.slice("--only-folder=".length)
+      : arg.slice("-ofo=".length);
+    if (!value) {
+      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
+    folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
+    folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
+    onlyFolders.add(folderName);
+    continue;
+  }
+
+  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;
+    }
+    if (consumed === 0) {
+      console.error("Error: --only-file requires at least one file name.");
+      process.exit(1);
+    }
+    continue;
+  }
+
+  if (arg.startsWith("--only-file=") || arg.startsWith("-ofi=")) {
+    const value = arg.startsWith("--only-file=") 
+      ? arg.slice("--only-file=".length)
+      : arg.slice("-ofi=".length);
+    if (!value) {
+      console.error("Error: --only-file requires a file name.");
+      process.exit(1);
+    }
+    onlyFiles.add(value);
+    continue;
+  }
+
+  if (arg.startsWith("-")) {
+    console.error(`Error: Unknown option "${arg}".`);
+    process.exit(1);
+  }
+
+  if (!outputArg) {
+    outputArg = arg;
+    continue;
+  }
+
+  console.error(`Error: Unexpected argument "${arg}".`);
+  process.exit(1);
+}
+
+// Validate split options
+if (splitMethod === 'size' && !splitSize) {
+  console.error("Error: --split-method size requires --split-size to be specified.");
+  process.exit(1);
+}
+
+if (splitSize && splitMethod !== 'size') {
+  console.error("Error: --split-size can only be used with --split-method size.");
+  process.exit(1);
+}
+
+const folderPath = process.cwd();
+const rootName = path.basename(folderPath);
+
+// Read .txtignore file if it exists
+const txtIgnore = readTxtIgnore(folderPath);
+
+const outputFile = outputArg
+  ? path.resolve(outputArg)
+  : path.join(process.cwd(), `${rootName}.txt`);
+
+console.log(`\n📂  Scanning: ${folderPath}`);
+
+const hasOnlyFilters = onlyFolders.size > 0 || onlyFiles.size > 0;
+const { lines: treeLines, filePaths } = collectFiles(
+  folderPath,
+  folderPath,
+  ignoreDirs,
+  ignoreFiles,
+  onlyFolders,
+  onlyFiles,
+  { hasOnlyFilters, rootName, txtIgnore, force: forceFlag },
+);
+
+// ── handle splitting ──────────────────────────────────────────────────────────────
+const effectiveMaxSize = noSkipFlag ? Infinity : maxFileSize;
+
+if (splitMethod) {
+  console.log(`🔧 Splitting output by: ${splitMethod}`);
+  
+  let results;
+  
+  if (splitMethod === 'folder') {
+    results = splitByFolders(treeLines, filePaths, rootName, effectiveMaxSize, forceFlag);
+  } else if (splitMethod === 'file') {
+    results = splitByFiles(filePaths, rootName, effectiveMaxSize, forceFlag);
+  } else if (splitMethod === 'size') {
+    results = splitBySize(treeLines, filePaths, rootName, splitSize, effectiveMaxSize, forceFlag);
+  }
+  
+  console.log(`✅  Done! Created ${results.length} split files:`);
+  console.log('');
+  
+  results.forEach((result, index) => {
+    if (splitMethod === 'folder') {
+      console.log(`📁  Folder: ${result.folder}`);
+    } else if (splitMethod === 'file') {
+      console.log(`📄  File: ${result.fileName}`);
+    } else if (splitMethod === 'size') {
+      console.log(`📦  Part ${result.part}`);
+    }
+    console.log(`📄  Output : ${result.file}`);
+    console.log(`📊  Size   : ${result.size} KB`);
+    console.log(`🗂️   Files  : ${result.files}`);
+    console.log('');
+  });
+  
+  if (copyToClipboardFlag) {
+    console.log('⚠️  --copy flag is not compatible with splitting - clipboard copy skipped');
+  }
+  
+  process.exit(0);
+}
+
+// ── build output (no splitting) ───────────────────────────────────────────────────
+const out = [];
+const divider    = "=".repeat(80);
+const subDivider = "-".repeat(80);
+
+out.push(divider);
+out.push(`START OF FOLDER: ${rootName}`);
+out.push(divider);
+out.push("");
+
+out.push(divider);
+out.push("PROJECT STRUCTURE");
+out.push(divider);
+out.push(`Root: ${folderPath}\n`);
+out.push(`${rootName}/`);
+treeLines.forEach(l => out.push(l));
+out.push("");
+out.push(`Total files: ${filePaths.length}`);
+out.push("");
+
+out.push(divider);
+out.push("FILE CONTENTS");
+out.push(divider);
+
+filePaths.forEach(({ abs, rel }) => {
+out.push("");
+out.push(subDivider);
+out.push(`FILE: ${rel}`);
+out.push(subDivider);
+const effectiveMaxSize = noSkipFlag ? Infinity : maxFileSize;
+out.push(readContent(abs, forceFlag, effectiveMaxSize));
+});
+
+out.push("");
+out.push(divider);
+out.push(`END OF FOLDER: ${rootName}`);
+out.push(divider);
+
+fs.writeFileSync(outputFile, out.join("\n"), "utf8");
+
+const sizeKB = (fs.statSync(outputFile).size / 1024).toFixed(1);
+console.log(`✅  Done!`);
+console.log(`📄  Output : ${outputFile}`);
+console.log(`📊  Size   : ${sizeKB} KB`);
+console.log(`🗂️   Files  : ${filePaths.length}`);
+
+if (copyToClipboardFlag) {
+  const content = fs.readFileSync(outputFile, 'utf8');
+  const success = copyToClipboard(content);
+  if (success) {
+    console.log(`📋  Copied to clipboard!`);
+  }
+}
+
+console.log('');
+
+
+--------------------------------------------------------------------------------
+FILE: /LICENSE
+--------------------------------------------------------------------------------
+MIT License
+
+Copyright (c) 2026 Muhammad Saad Amin @SENODROOM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
 --------------------------------------------------------------------------------
 FILE: /package.json
 --------------------------------------------------------------------------------
 {
   "name": "make-folder-txt",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "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": {
@@ -47,6 +967,343 @@ FILE: /package.json
 }
 
 
+--------------------------------------------------------------------------------
+FILE: /README.md
+--------------------------------------------------------------------------------
+<div align="center">
+
+# 📁 make-folder-txt
+
+**Instantly dump your entire project into a single, readable `.txt` file.**
+
+[![npm version](https://img.shields.io/npm/v/make-folder-txt?color=crimson&style=flat-square)](https://www.npmjs.com/package/make-folder-txt)
+[![npm downloads](https://img.shields.io/npm/dm/make-folder-txt?color=orange&style=flat-square)](https://www.npmjs.com/package/make-folder-txt)
+[![license](https://img.shields.io/npm/l/make-folder-txt?color=blue&style=flat-square)](./LICENSE)
+[![node](https://img.shields.io/node/v/make-folder-txt?color=green&style=flat-square)](https://nodejs.org)
+
+Perfect for sharing your codebase with **AI tools**, **teammates**, or **code reviewers** — without zipping files or giving repo access.
+
+[Installation](#-installation) · [Usage](#-usage) · [Help](#-get-help) · [Copy to Clipboard](#-copy-to-clipboard) · [Force Include Everything](#-force-include-everything) · [File Size Control](#-file-size-control) · [Output Splitting](#-output-splitting) · [Output Format](#-output-format) · [What Gets Skipped](#-what-gets-skipped) · [Contributing](#-contributing)
+
+</div>
+
+---
+
+## ✨ Why make-folder-txt?
+
+Ever needed to share your entire project with ChatGPT, Claude, or a teammate — but copy-pasting every file one by one is painful? **make-folder-txt** solves that in one command.
+
+- ✅ Run it from any project directory — no arguments needed
+- ✅ Built-in help system with `--help` flag
+- ✅ File size control with `--skip-large` and `--no-skip`
+- ✅ Output splitting by folders, files, or size
+- ✅ Copy to clipboard with `--copy` flag
+- ✅ Force include everything with `--force` flag
+- ✅ Generates a clean folder tree + every file's content
+- ✅ `.txtignore` support (works like `.gitignore`)
+- ✅ Automatically skips `node_modules`, binaries, and junk files
+- ✅ Zero dependencies — pure Node.js
+- ✅ Works on Windows, macOS, and Linux
+
+---
+
+## 📦 Installation
+
+Install globally once, use anywhere:
+
+```bash
+npm install -g make-folder-txt
+```
+
+---
+
+## 🚀 Usage
+
+Navigate into your project folder and run:
+
+```bash
+cd my-project
+make-folder-txt
+```
+
+That's it. A `my-project.txt` file will be created in the same directory.
+
+### 📖 Get Help
+
+```bash
+make-folder-txt --help      # Show all options and examples
+make-folder-txt -h          # Short version of help
+make-folder-txt --version   # Show version info
+make-folder-txt -v          # Short version of version
+```
+
+### 📋 Copy to Clipboard
+
+```bash
+make-folder-txt --copy      # Generate output and copy to clipboard
+make-folder-txt --copy --ignore-folder node_modules  # Copy filtered output
+```
+
+The `--copy` flag automatically copies the generated output to your system clipboard, making it easy to paste directly into AI tools, emails, or documents. Works on Windows, macOS, and Linux (requires `xclip` or `xsel` on Linux).
+
+### 🔥 Force Include Everything
+
+```bash
+make-folder-txt --force      # Include everything (overrides all ignore patterns)
+make-folder-txt --force --copy  # Include everything and copy to clipboard
+```
+
+The `--force` flag overrides all ignore patterns and includes:
+- `node_modules` and other ignored folders
+- Binary files (images, executables, etc.)
+- Large files (no 500 KB limit)
+- Files in `.txtignore`
+- System files and other normally skipped content
+
+Use this when you need a complete, unfiltered dump of your entire project.
+
+### 📏 File Size Control
+
+```bash
+make-folder-txt --skip-large 400KB     # Skip files larger than 400KB
+make-folder-txt --skip-large 5GB       # Skip files larger than 5GB
+make-folder-txt --skip-large 1.5MB     # Skip files larger than 1.5MB
+make-folder-txt --no-skip               # Include all files regardless of size
+```
+
+**Default behavior**: Files larger than 500KB are skipped by default.
+
+**Supported size units**:
+- **B** - Bytes
+- **KB** - Kilobytes (1024 bytes)
+- **MB** - Megabytes (1024 KB)
+- **GB** - Gigabytes (1024 MB)
+- **TB** - Terabytes (1024 GB)
+
+**Examples:**
+```bash
+# More restrictive - skip anything over 100KB
+make-folder-txt --skip-large 100KB
+
+# More permissive - allow files up to 10MB
+make-folder-txt --skip-large 10MB
+
+# Include everything - no size limits
+make-folder-txt --no-skip
+
+# Combine with other options
+make-folder-txt --skip-large 2MB --ignore-folder node_modules
+```
+
+**Size format**: Accepts decimal numbers (e.g., `1.5MB`, `0.5GB`) and various units.
+
+### 📂 Output Splitting
+
+```bash
+make-folder-txt --split-method folder    # Split by folders
+make-folder-txt --split-method file      # Split by files  
+make-folder-txt --split-method size --split-size 5MB  # Split by file size
+```
+
+**Split Methods:**
+- **`folder`** - Creates separate files for each folder
+- **`file`** - Creates separate files for each individual file
+- **`size`** - Splits output when content exceeds specified size
+
+**Examples:**
+```bash
+# Split by folders - creates folder-name.txt for each folder
+make-folder-txt --split-method folder
+
+# Split by files - creates filename.txt for each file
+make-folder-txt --split-method file
+
+# Split by size - creates part-1.txt, part-2.txt, etc.
+make-folder-txt --split-method size --split-size 5MB
+
+# Combine with other options
+make-folder-txt --split-method size --split-size 2MB --ignore-folder node_modules
+```
+
+**Output Files:**
+- **Folder method**: `projectname-foldername.txt`
+- **File method**: `projectname-filename.txt`  
+- **Size method**: `projectname-part-1.txt`, `projectname-part-2.txt`, etc.
+
+**Note**: Splitting is not compatible with `--copy` flag.
+
+Ignore specific folders/files by name:
+
+```bash
+make-folder-txt --ignore-folder examples extensions docs
+make-folder-txt -ifo examples extensions docs  # shorthand
+make-folder-txt --ignore-folder examples extensions "docs and explaination"
+make-folder-txt --ignore-folder examples extensions docs --ignore-file LICENSE
+make-folder-txt --ignore-file .env .env.local secrets.txt
+make-folder-txt -ifi .env .env.local secrets.txt  # shorthand
+```
+
+Use a `.txtignore` file (works like `.gitignore`):
+
+```bash
+# Create a .txtignore file in your project root
+echo "node_modules/" > .txtignore
+echo "*.log" >> .txtignore
+echo ".env" >> .txtignore
+echo "coverage/" >> .txtignore
+
+# The tool will automatically read and respect .txtignore patterns
+make-folder-txt
+```
+
+The `.txtignore` file supports:
+- File and folder names (one per line)
+- Wildcard patterns (`*.log`, `temp-*`)
+- Comments (lines starting with `#`)
+- Folder patterns with trailing slash (`docs/`)
+
+Include only specific folders/files by name (everything else is ignored):
+
+```bash
+make-folder-txt --only-folder src docs
+make-folder-txt -ofo src docs  # shorthand
+make-folder-txt --only-file package.json README.md
+make-folder-txt -ofi package.json README.md  # shorthand
+make-folder-txt --only-folder src --only-file package.json
+```
+
+---
+
+## 🎯 Real World Examples
+
+**Sharing with an AI tool (ChatGPT, Claude, etc.):**
+
+```bash
+cd "C:\Web Development\my-app\backend"
+make-folder-txt
+# → backend.txt created, ready to paste into any AI chat
+```
+
+**On macOS / Linux:**
+
+```bash
+cd /home/user/projects/my-app
+make-folder-txt
+# → my-app.txt created
+```
+
+---
+
+## 📄 Output Format
+
+The generated `.txt` file is structured in two clear sections:
+
+```
+================================================================================
+START OF FOLDER: my-project
+================================================================================
+
+================================================================================
+PROJECT STRUCTURE
+================================================================================
+Root: C:\Web Development\my-project
+
+my-project/
+├── src/
+│   ├── controllers/
+│   │   └── userController.js
+│   ├── models/
+│   │   └── User.js
+│   └── index.js
+├── node_modules/  [skipped]
+├── package.json
+└── README.md
+
+Total files: 5
+
+================================================================================
+FILE CONTENTS
+================================================================================
+
+--------------------------------------------------------------------------------
+FILE: /src/index.js
+--------------------------------------------------------------------------------
+const express = require('express');
+...
+
+--------------------------------------------------------------------------------
+FILE: /package.json
+--------------------------------------------------------------------------------
+{
+  "name": "my-project",
+  ...
+}
+
+================================================================================
+END OF FOLDER: my-project
+================================================================================
+```
+
+---
+
+## 🚫 What Gets Skipped
+
+The tool is smart about what it ignores so your output stays clean and readable.
+
+| Category        | Details                                                        |
+| --------------- | -------------------------------------------------------------- |
+| 📁 Folders      | `node_modules`, `.git`, `.next`, `dist`, `build`, `.cache`     |
+| 🖼️ Binary files | Images (`.png`, `.jpg`, `.gif`...), fonts, videos, executables |
+| 📦 Archives     | `.zip`, `.tar`, `.gz`, `.rar`, `.7z`                           |
+| 🔤 Font files   | `.woff`, `.woff2`, `.ttf`, `.eot`, `.otf`                      |
+| 📋 Lock files   | `package-lock.json`, `yarn.lock`                               |
+| 📏 Large files  | Any file over **500 KB**                                       |
+| 🗑️ System files | `.DS_Store`, `Thumbs.db`, `desktop.ini`                        |
+| 📄 Output file  | The generated `foldername.txt` file (to avoid infinite loops)   |
+| 📝 .txtignore   | Any files/folders specified in `.txtignore` file               |
+
+Binary and skipped files are noted in the output as `[binary / skipped]` so you always know what was omitted.
+
+---
+
+## 🛠️ Requirements
+
+- **Node.js** v14.0.0 or higher
+- No other dependencies
+
+---
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome!
+
+1. Fork the repository
+2. Create your feature branch: `git checkout -b feature/my-feature`
+3. Commit your changes: `git commit -m 'Add my feature'`
+4. Push to the branch: `git push origin feature/my-feature`
+5. Open a Pull Request
+
+---
+
+## 👤 Author
+
+**Muhammad Saad Amin**
+
+---
+
+## 📝 License
+
+This project is licensed under the **MIT License** — feel free to use it in personal and commercial projects.
+
+---
+
+<div align="center">
+
+If this tool saved you time, consider giving it a ⭐ on npm!
+
+</div>
+
+
 ================================================================================
 END OF FOLDER: make-folder-txt
 ================================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "make-folder-txt",
-  "version": "2.1.3",
+  "version": "2.1.4",
   "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": {