make-folder-txt 2.2.10 → 2.3.0

package/README.md

@@ -25,6 +25,7 @@ Ever needed to share your entire project with ChatGPT, Claude, or a teammate —
 - ✅ Built-in help system with `--help` flag
 - ✅ File size control with `--skip-large` and `--no-skip`
 - ✅ Output splitting by folders, files, or size
+- ✅ Reverse mode to recreate folders from generated `.txt` files
 - ✅ Copy to clipboard with `--copy` flag
 - ✅ Force include everything with `--force` flag
 - ✅ Generates a clean folder tree + every file's content
@@ -160,6 +161,16 @@ make-folder-txt --split-method size --split-size 2MB --ignore-folder node_module
 
 **Note**: Splitting is not compatible with `--copy` flag.
 
+### 🔄 Reverse a Txt Back Into a Folder
+
+```bash
+make-folder-txt --reverse                 # Restore from <current-folder>.txt
+make-folder-txt --reverse my-project.txt  # Restore from a specific dump
+make-folder-txt --reverse my-project.txt --force  # Overwrite existing restored files
+```
+
+The `--reverse` flag reads a `.txt` file created by `make-folder-txt` and recreates its files inside a folder named after the original dump. Existing files are skipped unless you add `--force`.
+
 Ignore specific folders/files by name:
 
 ```bash

package/bin/make-folder-txt.js

@@ -847,9 +847,9 @@ function createInteractiveConfig() {
   });
 }
 
-function loadConfig() {
-  const fs = require("fs");
-  const path = require("path");
+function loadConfig() {
+  const fs = require("fs");
+  const path = require("path");
 
   try {
     const configPath = path.join(process.cwd(), ".txtconfig");
@@ -863,12 +863,155 @@ function loadConfig() {
   } catch (err) {
     console.error("❌ Error loading configuration:", err.message);
     process.exit(1);
-  }
-}
-
-// ── main ──────────────────────────────────────────────────────────────────────
-
-async function main() {
+  }
+}
+
+function sanitizeRootName(name) {
+  return name
+    .replace(/[<>:"/\\|?*\x00-\x1F]/g, "-")
+    .replace(/^\.+$/, "restored-folder")
+    .trim();
+}
+
+function getReverseTargetPath(args) {
+  const reverseIndex = args.indexOf("--reverse");
+  const nextArg = args[reverseIndex + 1];
+
+  if (nextArg && !nextArg.startsWith("-")) {
+    return path.resolve(process.cwd(), nextArg);
+  }
+
+  return path.join(process.cwd(), `${path.basename(process.cwd())}.txt`);
+}
+
+function parseReverseDump(content, txtPath) {
+  const lines = content.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+  const dividerLine = /^={80}$/;
+  const fileDividerLine = /^-{80}$/;
+  const startLine = lines.find((line) => line.startsWith("START OF FOLDER: "));
+  const rootNameFromHeader = startLine
+    ? startLine
+        .slice("START OF FOLDER: ".length)
+        .replace(/\s+\(Part \d+\)$/, "")
+        .trim()
+    : "";
+  const rootName =
+    sanitizeRootName(rootNameFromHeader) ||
+    sanitizeRootName(path.basename(txtPath, path.extname(txtPath)));
+  const files = [];
+
+  for (let i = 0; i < lines.length; i += 1) {
+    if (
+      !lines[i].startsWith("FILE: ") ||
+      i === 0 ||
+      i + 1 >= lines.length ||
+      !fileDividerLine.test(lines[i - 1]) ||
+      !fileDividerLine.test(lines[i + 1])
+    ) {
+      continue;
+    }
+
+    const rel = lines[i]
+      .slice("FILE: ".length)
+      .replace(/\\/g, "/")
+      .replace(/^\/+/, "");
+
+    if (!rel || rel.includes("\0")) {
+      continue;
+    }
+
+    let end = lines.length;
+    for (let j = i + 2; j < lines.length; j += 1) {
+      const startsNextFile =
+        fileDividerLine.test(lines[j]) &&
+        j + 2 < lines.length &&
+        lines[j + 1].startsWith("FILE: ") &&
+        fileDividerLine.test(lines[j + 2]);
+      const startsFooter =
+        dividerLine.test(lines[j]) &&
+        j + 1 < lines.length &&
+        (lines[j + 1].startsWith("END OF FOLDER: ") ||
+          lines[j + 1].startsWith("END OF FILE: "));
+
+      if (startsNextFile || startsFooter) {
+        end = j;
+        break;
+      }
+    }
+
+    const contentLines = lines.slice(i + 2, end);
+    if (contentLines[contentLines.length - 1] === "") {
+      contentLines.pop();
+    }
+
+    files.push({
+      rel,
+      content: contentLines.join("\n"),
+    });
+  }
+
+  return { rootName, files };
+}
+
+function reverseTxtToFolder(txtPath, options = {}) {
+  if (!fs.existsSync(txtPath)) {
+    console.error(`Error: Reverse input file not found: ${txtPath}`);
+    process.exit(1);
+  }
+
+  const content = fs.readFileSync(txtPath, "utf8");
+  const { rootName, files } = parseReverseDump(content, txtPath);
+
+  if (files.length === 0) {
+    console.error(
+      "Error: No file content blocks found. Is this a make-folder-txt output file?",
+    );
+    process.exit(1);
+  }
+
+  const outputDir = path.join(process.cwd(), rootName);
+  const outputRoot = path.resolve(outputDir);
+  let written = 0;
+  let skipped = 0;
+
+  fs.mkdirSync(outputRoot, { recursive: true });
+
+  files.forEach(({ rel, content: fileContent }) => {
+    const destination = path.resolve(outputRoot, rel);
+
+    if (
+      destination !== outputRoot &&
+      !destination.startsWith(outputRoot + path.sep)
+    ) {
+      skipped += 1;
+      return;
+    }
+
+    if (fs.existsSync(destination) && !options.force) {
+      skipped += 1;
+      return;
+    }
+
+    fs.mkdirSync(path.dirname(destination), { recursive: true });
+    fs.writeFileSync(destination, fileContent, "utf8");
+    written += 1;
+  });
+
+  console.log(`✅  Done!`);
+  console.log(`📁  Folder : ${outputRoot}`);
+  console.log(`📄  Source : ${txtPath}`);
+  console.log(`🗂️   Files  : ${written}`);
+
+  if (skipped > 0) {
+    console.log(
+      `⚠️  Skipped: ${skipped} file${skipped === 1 ? "" : "s"} (use --force to overwrite existing files)`,
+    );
+  }
+}
+
+// ── main ──────────────────────────────────────────────────────────────────────
+
+async function main() {
   const args = process.argv.slice(2);
 
   if (args.includes("-v") || args.includes("--version")) {
@@ -882,7 +1025,7 @@ async function main() {
     process.exit(0);
   }
 
-  if (args.includes("--delete-config")) {
+  if (args.includes("--delete-config")) {
     try {
       const fs = require("fs");
       const path = require("path");
@@ -898,10 +1041,16 @@ async function main() {
     } catch (err) {
       console.error("❌ Error deleting configuration:", err.message);
     }
-    process.exit(0);
-  }
-
-  // Auto-use config if it exists and no other flags are provided
+    process.exit(0);
+  }
+
+  if (args.includes("--reverse")) {
+    const txtPath = getReverseTargetPath(args);
+    reverseTxtToFolder(txtPath, { force: args.includes("--force") });
+    process.exit(0);
+  }
+
+  // Auto-use config if it exists and no other flags are provided
   const configPath = path.join(process.cwd(), ".txtconfig");
   const hasConfig = fs.existsSync(configPath);
   const hasOtherFlags =
@@ -958,11 +1107,12 @@ Dump an entire project folder into a single readable .txt file.
   --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)
-  --make-config                       Create interactive configuration (with optional .gitignore setup)
-  --delete-config                     Delete configuration and reset to defaults
+  --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)
+  --reverse [file.txt]                Recreate a folder from a make-folder-txt output file
+  --make-config                       Create interactive configuration (with optional .gitignore setup)
+  --delete-config                     Delete configuration and reset to defaults
   --help, -h                          Show this help message
   --version, -v                       Show version information
 
@@ -973,10 +1123,13 @@ Dump an entire project folder into a single readable .txt file.
   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 --split-method folder
+  make-folder-txt --split-method file
+  make-folder-txt --split-method size --split-size 5MB
+  make-folder-txt --reverse
+  make-folder-txt --reverse my-project.txt
+  make-folder-txt --reverse my-project.txt --force
+  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

package/package.json

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