flatten-tool 1.6.3 → 1.7.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/flatten-tool)](https://www.npmjs.com/package/flatten-tool)
 
-A CLI utility to flatten directory structures, with perfect GitHub Flavored Markdown compatibility.
+A CLI utility to flatten directory structures, with perfect GitHub Flavored Markdown compatibility including explicit HTML anchors for maximum portability.
 
 [![Video thumbnail](https://i.ytimg.com/vi/LCbSoK0Mkjk/maxresdefault.jpg)](https://youtu.be/LCbSoK0Mkjk)  
 *Watch the YouTube video for an example of why you might need to flatten project files into a single document for AI discussions and code reviews.*
@@ -143,6 +143,9 @@ This project uses Bun for runtime, TypeScript for type safety, and follows the g
 
 ## Changelog
 
+### v1.7.0
+- Added explicit HTML anchors (`<a id="..."></a>`) before all headings for guaranteed compatibility across platforms that don't auto-generate heading IDs, maximum control over anchor names, and stable links.
+
 ### v1.6.3
 - Enhanced safety: Automatically exclude common binary file extensions (PNG, JPEG, PDF, archives, executables, etc.) when merging to Markdown to prevent corruption.
 - Added `--ignore` CLI option: Allow additional glob patterns to ignore (e.g., `*.log`, `temp/**`).

package/index.ts

@@ -178,7 +178,7 @@ export async function flattenDirectory(
       const indent = '  '.repeat(depth);
 
       // Add .. if we have a parent
-      if (parentPath !== null) {
+      if (parentPath !== null && depth === 0) {
         const parentAnchor = anchorMap.get(parentPath) ?? '';
         result += `${indent}- [..](#${parentAnchor})\n`;
       }
@@ -220,7 +220,7 @@ export async function flattenDirectory(
     }
 
     // Render global tree with correct anchors
-    let treeMarkdown = "# Project File Tree\n\n";
+    let treeMarkdown = `<a id="${anchorMap.get('')!}"></a>\n# Project File Tree\n\n`;
     treeMarkdown += renderMarkdownTree(treeObj, 0, '', anchorMap, null);
     treeMarkdown += "\n\n";
 
@@ -259,7 +259,8 @@ export async function flattenDirectory(
 
       // Directory section (only for non-root) — no trailing /
       if (currentPath) {
-        writeStream.write(`# ${currentPath}\n\n`);
+        const anchor = anchorMap.get(currentPath)!;
+        writeStream.write(`<a id="${anchor}"></a>\n# ${currentPath}\n\n`);
         writeStream.write(`File Tree\n\n`);
 
         const parentPath = currentPath.includes('/')
@@ -271,7 +272,8 @@ export async function flattenDirectory(
       }
 
       for (const file of files) {
-        writeStream.write(`# ${file.relPath}\n\n`);
+        const anchor = anchorMap.get(file.relPath)!;
+        writeStream.write(`<a id="${anchor}"></a>\n# ${file.relPath}\n\n`);
 
         let ext = extname(file.srcPath).slice(1) || 'text';
         const lang = ext;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flatten-tool",
-  "version": "1.6.3",
+  "version": "1.7.0",
   "description": "CLI tool to flatten directory structures: merge files into a single Markdown file (default) or copy/move to a flat directory with escaped filenames. Respects .gitignore, supports move/overwrite, and more.",
   "module": "index.ts",
   "type": "module",