ezctx 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 arhayashi
+
+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.

package/README.md

@@ -0,0 +1,108 @@
+# ezctx
+
+**ezctx** (short for _easy context_) puts all of your source code into one or several `.txt` file(s), allowing you to easily paste it into an external AI platform instead of having to tediously upload each individual file.
+
+In addition, this program adds a graph/visualization of your project's files/directories to the first output `.txt` file, helping the AI map your project.
+
+This program's "bundling" behavior can be modied by adding a configuration file. See below for usage, description, and configuration options.
+
+## Usage
+
+```
+npx ezctx
+```
+
+-   Node.js version must support the promised-based `fs` API.
+-   The program outputs the `.txt` file(s) wherever the command was executed.
+
+## Description
+
+_To view an example of this program's output, see [ezctx_1.txt](https://github.com/arhayashi/ezctx/blob/main/ezctx_1.txt)_.
+
+When running this program, please ensure that your project has read and write permissions enabled or an error will be thrown.
+
+### Default Behavior
+
+This section will describe the program's **default** behavior and some of the ways it can be modified using the [configuration](#configuration) file.
+
+This program recursively writes your projects's source code into a singular `.txt` file so that you can easily access all your source code in a central location. Because this program does not require an npm installation, you can use it with projects that use different languages outside of the Node.js/npm ecosystem.
+
+For instance, if you `cd` into a directory, `my_project`, executing `npx ezctx` will produce `my_project/ezctx_1.txt` containing all of your project's source code. If you need the outputted `.txt` file to be smaller, you can change the configuration's `chunkSize` which will ensure that each output file is no larger than `chunkSize`. This may result in serveral output `.txt` files in the format `ezctx_{i}.txt` where `i` corresponds to the `nth` output file. Note that if there are multiple output `.txt` files, they will live under the `ezctx` directory. Otherwise, the singular output `.txt` file will live wherever the `npx ezctx` commands was executed. These default behaviors can be modified in the program's [configuration](#configuration).
+
+This program runs on a _file-by-file_ basis to ensure that the size of the content in the current source code file plus the content in the current output `.txt` file is less than `chunkSize`. Effectively, this means that if one of your source code files is greater than `chunkSize`, it will not be added to an output `.txt` file.
+
+### Output File
+
+Before writing your project's source code to the output `.txt` file(s), this program creates a visualization of your project's files/directories from a recursively created graph. This visualization is added only to the first outputted `.txt` file. For example, the visualization of _this program_ looks like the below and is the first item written to the `ezctx_1.txt` output.
+
+```
+*** project structure ***
+
+\ezctx
+|__.ezctxrc.json
+|__README.md
+|__src/
+   |__config.type.ts
+   |__index.ts
+   |__utils/
+      |__buildGraph.ts
+      |__loadConfig.ts
+      |__outputFormatter.ts
+      |__stringFormatter.ts
+      |__utils.type.ts
+      |__visualizeGraph.ts
+      |__writeOutput.ts
+|__tsconfig.json
+
+```
+
+Additionally, when writing each of your project's files to the output `.txt` file(s), they will be in the format defined below and will go under your project's visualization.
+
+```
+*** {file_name_1} ***
+
+// ...
+
+*** {file_name_2} ***
+
+// ...
+
+```
+
+## Configuration
+
+To modify this program's default "bundling" behavior, add a `JSON` file in the same directory where the `npx ezctx` command will be executed. This configuration file must contain the substring "ezctx" within its name, like `ezctx.config.json`, `.ezctxrc.json`, or `ezctx.json`. The modifiable configuration fields are defined below.
+
+### Configuration Options
+
+| Field              | Type       | Description                                                                                                                                                                                                                                                                     |
+| ------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `chunkSize`        | `number`   | The maximum size (in bytes) of each output `.txt` file. This program's recursive process occurs on a file-by-file basis, so if a file's size is larger than `chunkSize`, it will not be included in the output `.txt` file(s).                                                  |
+| `defaultIgnores`   | `boolean`  | Wether to use the program's default ignores. If `true`, the user defined `ignores` will be merged with the program's default `ignores` (see the default config below). If `false`, only the user defined `ignores` will be used.                                                |
+| `ignores`          | `string[]` | The files/directories that will not be included in the output `.txt` file(s).                                                                                                                                                                                                   |
+| `outDir`           | `string`   | The name of the directory where the output `.txt` file(s) will live under.                                                                                                                                                                                                      |
+| `outDirSingleEmit` | `boolean`  | Applies when there is only a single output `.txt` file. If `true`, the outputted `.txt` file will live under `outDir`. If `false`, it will be placed wherever the `npx ezctx` command was executed.                                                                             |
+| `outFile`          | `string`   | The name of each output `.txt` file. Add `{i}` to denote where the file's numbering should go within its name. If `{i}` is not included, the file's numbering (along with an underscore) will be added to the end of the file's name by default (see the default config below). |
+
+### Default Configuration
+
+If no configuration file is defined, or a field is omitted, the default configuration/corresponding field (defined below) will be used instead.
+
+```
+{
+    chunkSize: Infinity,
+    defaultIgnores: true,
+    ignores: [
+        "node_modules",
+        "package-lock.json",
+        "package.json",
+        ".git",
+        ".gitignore",
+        ".DS_Store",
+        ".vscode",
+    ],
+    outDir: "ezctx",
+    outDirSingleEmit: false,
+    outFile: "ezctx_{i}.txt"
+}
+```

package/dist/config.type.d.ts

@@ -0,0 +1,9 @@
+export type Config = {
+    chunkSize: number;
+    ignores: string[];
+    outDir: string;
+    outDirSingleEmit: boolean;
+    defaultIgnores: boolean;
+    outFile: string;
+};
+//# sourceMappingURL=config.type.d.ts.map

package/dist/config.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.type.d.ts","sourceRoot":"","sources":["../src/config.type.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,MAAM,GAAG;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/config.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.type.js.map

package/dist/config.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.type.js","sourceRoot":"","sources":["../src/config.type.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import * as fs from "node:fs/promises";
+import path from "node:path";
+import buildGraph from "./utils/buildGraph.js";
+import visualizeGraph from "./utils/visualizeGraph.js";
+import writeOutput from "./utils/writeOutput.js";
+import loadConfig from "./utils/loadConfig.js";
+import outputFormatter from "./utils/outputFormatter.js";
+try {
+    // loads in the configs
+    const config = await loadConfig();
+    const ignores = config["ignores"];
+    const outDir = config["outDir"];
+    const outDirSingleEmit = config["outDirSingleEmit"];
+    const outFile = config["outFile"];
+    const chunkSize = config["chunkSize"];
+    // builds graph
+    let graph = await buildGraph(process.cwd(), ignores);
+    // creates visualization from the graph
+    const visualization = "*** project structure ***\n\n" + visualizeGraph(graph) + "\n";
+    // creates output directory; removes previous ones
+    const finalOutDir = path.join(process.cwd(), outDir);
+    await fs.rm(finalOutDir, { recursive: true, force: true });
+    await fs.mkdir(finalOutDir, { recursive: true });
+    // creates output path;
+    const finalOutPath = path.join(finalOutDir, outFile);
+    // creates path of the first output file
+    const firstFinalOutPath = outputFormatter(finalOutPath, 1);
+    // writes the visualization to the first output file
+    await fs.writeFile(firstFinalOutPath, visualization, {
+        flag: "w+",
+    });
+    // count object to access number of output files
+    // from outside the writeOutput function
+    const count = { count: 1 };
+    // adds file contents to output
+    await writeOutput(graph, finalOutPath, chunkSize, count);
+    // creates path for single emits
+    const singleEmitOutPath = path.join(process.cwd(), path.basename(firstFinalOutPath));
+    // detects if only a single output file and emits it
+    // in the working directory instead of the outDir
+    if (count.count === 1 && !outDirSingleEmit) {
+        // creates path of the first output file for single emits
+        await fs.rename(firstFinalOutPath, singleEmitOutPath);
+        await fs.rm(finalOutDir, { recursive: true, force: true });
+    }
+    else {
+        await fs.rm(singleEmitOutPath, { force: true });
+    }
+}
+catch (error) {
+    if (error instanceof Error) {
+        console.log(error.message);
+    }
+    else {
+        console.log(error);
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.type.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.type.d.ts.map

package/dist/index.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.type.d.ts","sourceRoot":"","sources":["../src/index.type.ts"],"names":[],"mappings":""}

package/dist/index.type.js

@@ -0,0 +1,8 @@
+export {};
+// export type Node = {
+//     name: string;
+//     path: string;
+//     type: string;
+//     children?: undefined | Node[];
+// };
+//# sourceMappingURL=index.type.js.map

package/dist/index.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.type.js","sourceRoot":"","sources":["../src/index.type.ts"],"names":[],"mappings":";AAAA,uBAAuB;AACvB,oBAAoB;AACpB,oBAAoB;AACpB,oBAAoB;AACpB,qCAAqC;AACrC,KAAK"}

package/dist/test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../test.ts"],"names":[],"mappings":""}

package/dist/test.js

@@ -0,0 +1,21 @@
+// const INDENT = "    ";
+// const SUB_CONTENT = "|____";
+export {};
+// function printStructure(file: string, type: "dir" | "file"): string {
+//     return "t";
+// }
+/*
+
+***PROJECT_STRUCTURE***
+
+path
+|____hello world
+|____hello world
+    |____test
+
+
+**********************
+
+
+*/
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../test.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,+BAA+B;;AAG/B,wEAAwE;AACxE,kBAAkB;AAClB,IAAI;AAEJ;;;;;;;;;;;;;EAaE"}

package/dist/utils/buildGraph.d.ts

@@ -0,0 +1,13 @@
+import type { FileNode } from "./utils.type.js";
+/**
+ * Recursively constructs a graph of the project starting from the path
+ * given by dirPath.
+ *
+ * @param dirPath Path where the graph should start
+ * @param ignores Directories/filters to ignore
+ * @param maxDepth Max depth to recurse to prevent infinite recursion
+ * @param depth Current depth
+ * @returns FileNode object
+ */
+export default function buildGraph(dirPath: string, ignores?: string[], maxDepth?: number, depth?: number): Promise<FileNode>;
+//# sourceMappingURL=buildGraph.d.ts.map

package/dist/utils/buildGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGraph.d.ts","sourceRoot":"","sources":["../../src/utils/buildGraph.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAA8B,UAAU,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAM,EAAO,EACtB,QAAQ,GAAE,MAAa,EACvB,KAAK,GAAE,MAAU,GAClB,OAAO,CAAC,QAAQ,CAAC,CAyCnB"}

package/dist/utils/buildGraph.js

@@ -0,0 +1,38 @@
+import * as fs from "node:fs/promises";
+import path from "node:path";
+/**
+ * Recursively constructs a graph of the project starting from the path
+ * given by dirPath.
+ *
+ * @param dirPath Path where the graph should start
+ * @param ignores Directories/filters to ignore
+ * @param maxDepth Max depth to recurse to prevent infinite recursion
+ * @param depth Current depth
+ * @returns FileNode object
+ */
+export default async function buildGraph(dirPath, ignores = [], maxDepth = 1000, depth = 0) {
+    // gets name of directory/file
+    const name = path.basename(dirPath);
+    // get stats about directory/file
+    const stats = await fs.stat(dirPath);
+    // creates a new node
+    const fileNode = {
+        name,
+        path: dirPath,
+        type: stats.isDirectory() ? "directory" : "file",
+        depth,
+        size: stats.size,
+    };
+    // recursively adds children nodes
+    if (stats.isDirectory() && depth < maxDepth) {
+        // gets all the files/directories within the current one
+        const entries = await fs.readdir(dirPath);
+        // filter out ignores files/directories
+        let filteredEntries = entries.filter((entry) => !ignores.includes(entry));
+        // add sub-directories and their files
+        // as a children property to the parent node
+        fileNode.children = await Promise.all(filteredEntries.map((entry) => buildGraph(path.join(dirPath, entry), ignores, maxDepth, depth + 1)));
+    }
+    return fileNode;
+}
+//# sourceMappingURL=buildGraph.js.map

package/dist/utils/buildGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGraph.js","sourceRoot":"","sources":["../../src/utils/buildGraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,UAAU,CACpC,OAAe,EACf,UAAoB,EAAE,EACtB,WAAmB,IAAI,EACvB,QAAgB,CAAC;IAEjB,8BAA8B;IAC9B,MAAM,IAAI,GAAW,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE5C,iCAAiC;IACjC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAErC,qBAAqB;IACrB,MAAM,QAAQ,GAAa;QACvB,IAAI;QACJ,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;QAChD,KAAK;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;KACnB,CAAC;IAEF,kCAAkC;IAClC,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;QAC1C,wDAAwD;QACxD,MAAM,OAAO,GAAa,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEpD,uCAAuC;QACvC,IAAI,eAAe,GAAa,OAAO,CAAC,MAAM,CAC1C,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CACtC,CAAC;QAEF,sCAAsC;QACtC,4CAA4C;QAC5C,QAAQ,CAAC,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1B,UAAU,CACN,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,EACzB,OAAO,EACP,QAAQ,EACR,KAAK,GAAG,CAAC,CACZ,CACJ,CACJ,CAAC;IACN,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/utils/getConfig.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getConfig.d.ts.map

package/dist/utils/getConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConfig.d.ts","sourceRoot":"","sources":["../../src/utils/getConfig.ts"],"names":[],"mappings":""}

package/dist/utils/getConfig.js

@@ -0,0 +1,4 @@
+import { cosmiconfig } from "cosmiconfig";
+const explorer = cosmiconfig("ezctx");
+explorer.search().then(result => console.log(result));
+//# sourceMappingURL=getConfig.js.map

package/dist/utils/getConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getConfig.js","sourceRoot":"","sources":["../../src/utils/getConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AACtC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/utils/loadConfig.d.ts

@@ -0,0 +1,10 @@
+import type { Config } from "../config.type.js";
+/**
+ * Loads in the user's config and merges it with default config
+ * to fill undefined fields. Assumes the user's config is in the
+ * same directory as process.cwd(), contains "ezctx", and is a JSON file.
+ *
+ * @returns Config
+ */
+export default function loadConfig(): Promise<Config>;
+//# sourceMappingURL=loadConfig.d.ts.map

package/dist/utils/loadConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../../src/utils/loadConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAwBhD;;;;;;GAMG;AACH,wBAA8B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CA8C1D"}

package/dist/utils/loadConfig.js

@@ -0,0 +1,63 @@
+import fs from "node:fs/promises";
+import outputFormatter from "./outputFormatter.js";
+// default ignores
+const _defaultIgnores = [
+    "node_modules",
+    "package-lock.json",
+    "package.json",
+    ".git",
+    ".gitignore",
+    ".DS_Store",
+    ".vscode",
+];
+// default config
+const defaultConfig = {
+    chunkSize: Infinity,
+    defaultIgnores: true,
+    ignores: _defaultIgnores,
+    outDir: "ezctx",
+    outDirSingleEmit: false,
+    outFile: "ezctx_{i}.txt",
+};
+/**
+ * Loads in the user's config and merges it with default config
+ * to fill undefined fields. Assumes the user's config is in the
+ * same directory as process.cwd(), contains "ezctx", and is a JSON file.
+ *
+ * @returns Config
+ */
+export default async function loadConfig() {
+    // searches for a user-defined config
+    let userConfig;
+    const userConfigName = (await fs.readdir(process.cwd())).find((file) => file.includes("ezctx"));
+    if (userConfigName) {
+        userConfig = JSON.parse(await fs.readFile(userConfigName, "utf-8"));
+    }
+    else {
+        userConfig = defaultConfig;
+    }
+    // merges the program's default ignores with
+    // the user-defined ignores
+    // stores the merged ignores
+    let mergedIgnores;
+    if (userConfig.defaultIgnores === undefined || userConfig.defaultIgnores) {
+        mergedIgnores = [..._defaultIgnores, ...(userConfig.ignores || [])];
+    }
+    else {
+        mergedIgnores = [...(userConfig.ignores || [])];
+    }
+    // add program's output directory and output file to ignores
+    // to prevent duplicate writes
+    mergedIgnores.push(userConfig.outDir || defaultConfig.outDir);
+    mergedIgnores.push(userConfig.outFile
+        ? outputFormatter(userConfig.outFile, 1)
+        : outputFormatter(defaultConfig.outFile, 1));
+    // creates merged config
+    const mergedConfig = {
+        ...defaultConfig,
+        ...Object.fromEntries(Object.entries(userConfig).filter(([_, value]) => value !== undefined)),
+        ignores: mergedIgnores,
+    };
+    return mergedConfig;
+}
+//# sourceMappingURL=loadConfig.js.map

package/dist/utils/loadConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadConfig.js","sourceRoot":"","sources":["../../src/utils/loadConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,OAAO,eAAe,MAAM,sBAAsB,CAAC;AAEnD,kBAAkB;AAClB,MAAM,eAAe,GAAa;IAC9B,cAAc;IACd,mBAAmB;IACnB,cAAc;IACd,MAAM;IACN,YAAY;IACZ,WAAW;IACX,SAAS;CACZ,CAAC;AAEF,iBAAiB;AACjB,MAAM,aAAa,GAAW;IAC1B,SAAS,EAAE,QAAQ;IACnB,cAAc,EAAE,IAAI;IACpB,OAAO,EAAE,eAAe;IACxB,MAAM,EAAE,OAAO;IACf,gBAAgB,EAAE,KAAK;IACvB,OAAO,EAAE,eAAe;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,UAAU;IACpC,qCAAqC;IACrC,IAAI,UAA2B,CAAC;IAChC,MAAM,cAAc,GAAuB,CACvC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAClC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzC,IAAI,cAAc,EAAE,CAAC;QACjB,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;SAAM,CAAC;QACJ,UAAU,GAAG,aAAa,CAAC;IAC/B,CAAC;IAED,4CAA4C;IAC5C,2BAA2B;IAE3B,4BAA4B;IAC5B,IAAI,aAAuB,CAAC;IAE5B,IAAI,UAAU,CAAC,cAAc,KAAK,SAAS,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;QACvE,aAAa,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;SAAM,CAAC;QACJ,aAAa,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,4DAA4D;IAC5D,8BAA8B;IAC9B,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9D,aAAa,CAAC,IAAI,CACd,UAAU,CAAC,OAAO;QACd,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAClD,CAAC;IAEF,wBAAwB;IACxB,MAAM,YAAY,GAAW;QACzB,GAAG,aAAa;QAChB,GAAG,MAAM,CAAC,WAAW,CACjB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAC7B,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CACtC,CACJ;QACD,OAAO,EAAE,aAAa;KACzB,CAAC;IAEF,OAAO,YAAY,CAAC;AACxB,CAAC"}

package/dist/utils/outputFormatter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Takes in a path or file and embeds the current file count
+ * within the output file defined in the config. If the raw
+ * output file does not define a place to embed the count, this
+ * program defaulty adds "_{count}" before the file name.
+ *
+ * @param outFile The raw output file format defined in the config
+ * @param count The nth output file that is being created
+ * @returns A formatted path/file name with the count embedded
+ */
+export default function outputFormatter(outputPath: string, count: number): string;
+//# sourceMappingURL=outputFormatter.d.ts.map

package/dist/utils/outputFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputFormatter.d.ts","sourceRoot":"","sources":["../../src/utils/outputFormatter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,MAAM,CAAC,OAAO,UAAU,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACd,MAAM,CAqBR"}

package/dist/utils/outputFormatter.js

@@ -0,0 +1,30 @@
+import path from "node:path";
+/**
+ * Takes in a path or file and embeds the current file count
+ * within the output file defined in the config. If the raw
+ * output file does not define a place to embed the count, this
+ * program defaulty adds "_{count}" before the file name.
+ *
+ * @param outFile The raw output file format defined in the config
+ * @param count The nth output file that is being created
+ * @returns A formatted path/file name with the count embedded
+ */
+export default function outputFormatter(outputPath, count) {
+    // extracts the file name
+    const fileName = path.basename(outputPath);
+    // extracts the file dirname
+    const dirName = path.dirname(outputPath);
+    // gets index of the section to replace with the
+    // current file count
+    const index = fileName.indexOf("{i}");
+    if (index == -1) {
+        // if not defined, add default count
+        const fileNameParts = fileName.split(".");
+        const finalOutputFile = fileNameParts[0] + `_${count}.` + fileNameParts[1];
+        return path.join(dirName, finalOutputFile);
+    }
+    // otherwise, replace the {i} with the current file count
+    const finalOutputFile = fileName.substring(0, index) + count + fileName.substring(index + 3);
+    return path.join(dirName, finalOutputFile);
+}
+//# sourceMappingURL=outputFormatter.js.map

package/dist/utils/outputFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputFormatter.js","sourceRoot":"","sources":["../../src/utils/outputFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;GASG;AAEH,MAAM,CAAC,OAAO,UAAU,eAAe,CACnC,UAAkB,EAClB,KAAa;IAEb,yBAAyB;IACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC3C,4BAA4B;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,gDAAgD;IAChD,qBAAqB;IACrB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;QACd,oCAAoC;QACpC,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,eAAe,GACjB,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAC/C,CAAC;IAED,yDAAyD;IACzD,MAAM,eAAe,GACjB,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AAC/C,CAAC"}

package/dist/utils/stringFormatter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Formats a given resource by adding spacing and lines
+ * to ensure that it is properly placed when creating a
+ * visualization of the project's structure
+ *
+ * @param depth Current depth within the graph
+ * @param name Name of the file/directory
+ * @param type Type of the given resource
+ * @returns A formatted string of the resource
+ */
+export default function stringFormatter(depth: number, name: string, type: "directory" | "file"): string;
+//# sourceMappingURL=stringFormatter.d.ts.map

package/dist/utils/stringFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringFormatter.d.ts","sourceRoot":"","sources":["../../src/utils/stringFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,OAAO,UAAU,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,GAAG,MAAM,GAC3B,MAAM,CAKR"}

package/dist/utils/stringFormatter.js

@@ -0,0 +1,17 @@
+/**
+ * Formats a given resource by adding spacing and lines
+ * to ensure that it is properly placed when creating a
+ * visualization of the project's structure
+ *
+ * @param depth Current depth within the graph
+ * @param name Name of the file/directory
+ * @param type Type of the given resource
+ * @returns A formatted string of the resource
+ */
+export default function stringFormatter(depth, name, type) {
+    return depth == 0
+        ? `\\${name}\n`
+        : `   `.repeat(depth - 1) +
+            `|__${name}${type === "directory" ? "/" : ""}\n`;
+}
+//# sourceMappingURL=stringFormatter.js.map

package/dist/utils/stringFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringFormatter.js","sourceRoot":"","sources":["../../src/utils/stringFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,OAAO,UAAU,eAAe,CACnC,KAAa,EACb,IAAY,EACZ,IAA0B;IAE1B,OAAO,KAAK,IAAI,CAAC;QACb,CAAC,CAAC,KAAK,IAAI,IAAI;QACf,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;YACnB,MAAM,IAAI,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;AAC/D,CAAC"}

package/dist/utils/utils.type.d.ts

@@ -0,0 +1,9 @@
+export type FileNode = {
+    name: string;
+    path: string;
+    type: "directory" | "file";
+    size: number;
+    depth: number;
+    children?: undefined | FileNode[];
+};
+//# sourceMappingURL=utils.type.d.ts.map

package/dist/utils/utils.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.type.d.ts","sourceRoot":"","sources":["../../src/utils/utils.type.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,EAAE,CAAC;CACrC,CAAC"}

package/dist/utils/utils.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utils.type.js.map

package/dist/utils/utils.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.type.js","sourceRoot":"","sources":["../../src/utils/utils.type.ts"],"names":[],"mappings":""}

package/dist/utils/visualizeGraph.d.ts

@@ -0,0 +1,11 @@
+import type { FileNode } from "./utils.type.js";
+/**
+ * Recursively creates a visualization of the project's graph.
+ * Uses stringFormatter.ts to format each directory/file
+ *
+ * @param graph Project's graph
+ * @param output Store's recursive output
+ * @returns A visualization of the given graph
+ */
+export default function visualizeGraph(graph: FileNode | FileNode[] | undefined, output?: string): string;
+//# sourceMappingURL=visualizeGraph.d.ts.map

package/dist/utils/visualizeGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualizeGraph.d.ts","sourceRoot":"","sources":["../../src/utils/visualizeGraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;GAOG;AAEH,MAAM,CAAC,OAAO,UAAU,cAAc,CAClC,KAAK,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,SAAS,EACxC,MAAM,GAAE,MAAW,GACpB,MAAM,CAgBR"}

package/dist/utils/visualizeGraph.js

@@ -0,0 +1,27 @@
+import stringFormatter from "./stringFormatter.js";
+/**
+ * Recursively creates a visualization of the project's graph.
+ * Uses stringFormatter.ts to format each directory/file
+ *
+ * @param graph Project's graph
+ * @param output Store's recursive output
+ * @returns A visualization of the given graph
+ */
+export default function visualizeGraph(graph, output = "") {
+    // if graph is undefined, reach end/tip
+    if (!graph)
+        return output;
+    // if not array, it's the root or a child within an array
+    if (!Array.isArray(graph)) {
+        output += stringFormatter(graph.depth, graph.name, graph.type);
+        output = visualizeGraph(graph.children, output);
+    }
+    else {
+        graph.forEach((child) => {
+            output += stringFormatter(child.depth, child.name, child.type);
+            output = visualizeGraph(child.children, output);
+        });
+    }
+    return output;
+}
+//# sourceMappingURL=visualizeGraph.js.map

package/dist/utils/visualizeGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualizeGraph.js","sourceRoot":"","sources":["../../src/utils/visualizeGraph.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,MAAM,sBAAsB,CAAC;AAEnD;;;;;;;GAOG;AAEH,MAAM,CAAC,OAAO,UAAU,cAAc,CAClC,KAAwC,EACxC,SAAiB,EAAE;IAEnB,uCAAuC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAE1B,yDAAyD;IACzD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACJ,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/D,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/utils/writeFiles.d.ts

@@ -0,0 +1,16 @@
+import type { FileNode } from "./utils.type.js";
+/**
+ * Recursively adds content to the output files while ensuring
+ * that the size of each output file is less than the given chunkSize.
+ * If it is, it starts a new output file with the file namen given in
+ * outputPath.
+ *
+ * @param {FileNode | FileNode[] | undefined} graph Project's graph
+ * @param {string} outputPath The path to write output to
+ * @param {number} chunkSize The max size of each output file
+ * @param {number} count The count of the current output file
+ */
+export default function writeFiles(graph: FileNode | FileNode[] | undefined, outputPath: string, chunkSize: number, count?: {
+    count: number;
+}): Promise<void>;
+//# sourceMappingURL=writeFiles.d.ts.map

package/dist/utils/writeFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFiles.d.ts","sourceRoot":"","sources":["../../src/utils/writeFiles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;GAUG;AAEH,wBAA8B,UAAU,CACpC,KAAK,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,SAAS,EACxC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAiB,GACxC,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/utils/writeFiles.js

@@ -0,0 +1,52 @@
+import * as fs from "node:fs/promises";
+import outputFormatter from "./outputFormatter.js";
+/**
+ * Recursively adds content to the output files while ensuring
+ * that the size of each output file is less than the given chunkSize.
+ * If it is, it starts a new output file with the file namen given in
+ * outputPath.
+ *
+ * @param {FileNode | FileNode[] | undefined} graph Project's graph
+ * @param {string} outputPath The path to write output to
+ * @param {number} chunkSize The max size of each output file
+ * @param {number} count The count of the current output file
+ */
+export default async function writeFiles(graph, outputPath, chunkSize, count = { count: 1 }) {
+    // if graph is null/undefined, reach tip
+    if (!graph)
+        return;
+    // turn current node into array to handle empty directories
+    const nodes = Array.isArray(graph) ? graph : [graph];
+    // recursively adds each nodes' file content to the output
+    for (const node of nodes) {
+        if (node.type === "directory") {
+            await writeFiles(node.children, outputPath, chunkSize, count);
+        }
+        else if (node.type === "file") {
+            // get file's content and add formatting
+            const content = "*** " +
+                node.name +
+                " ***" +
+                "\n\n" +
+                (await fs.readFile(node.path)) +
+                "\n";
+            // get the correct output path 
+            let currentPath = outputFormatter(outputPath, count.count);
+            // get the size of the current content
+            const contentSize = Buffer.byteLength(content, "utf-8");
+            // try-catch block because the currentPath may be exist on disk
+            // ie. first time writing to this output file
+            try {
+                // get size of current output file
+                const { size } = await fs.stat(currentPath);
+                // ensures that the chunkSize condition is respected
+                if (size > 0 && contentSize + size > chunkSize) {
+                    currentPath = outputFormatter(outputPath, ++count.count);
+                }
+            }
+            catch (error) { }
+            await fs.writeFile(currentPath, content, { flag: "a" });
+        }
+    }
+}
+//# sourceMappingURL=writeFiles.js.map

package/dist/utils/writeFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFiles.js","sourceRoot":"","sources":["../../src/utils/writeFiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,eAAe,MAAM,sBAAsB,CAAC;AAEnD;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,UAAU,CACpC,KAAwC,EACxC,UAAkB,EAClB,SAAiB,EACjB,QAA2B,EAAE,KAAK,EAAE,CAAC,EAAE;IAEvC,wCAAwC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,2DAA2D;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAErD,0DAA0D;IAC1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC5B,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAClE,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,wCAAwC;YACxC,MAAM,OAAO,GACT,MAAM;gBACN,IAAI,CAAC,IAAI;gBACT,MAAM;gBACN,MAAM;gBACN,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9B,IAAI,CAAC;YACT,+BAA+B;YAC/B,IAAI,WAAW,GAAG,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3D,sCAAsC;YACtC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACxD,+DAA+D;YAC/D,6CAA6C;YAC7C,IAAI,CAAC;gBACD,kCAAkC;gBAClC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC5C,oDAAoD;gBACpD,IAAI,IAAI,GAAG,CAAC,IAAI,WAAW,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC;oBAC7C,WAAW,GAAG,eAAe,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC7D,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC,CAAA,CAAC;YAElB,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5D,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/utils/writeOutput.d.ts

@@ -0,0 +1,16 @@
+import type { FileNode } from "./utils.type.js";
+/**
+ * Recursively adds content to the output files while ensuring
+ * that the size of each output file is less than the given chunkSize.
+ * If it is, it starts a new output file with the file namen given in
+ * outputPath. Stores the count as an object to have it persist.
+ *
+ * @param graph Project's graph
+ * @param outputPath The path to write output to
+ * @param chunkSize The max size of each output file
+ * @param count The count of the current output file
+ */
+export default function writeOutput(graph: FileNode | FileNode[] | undefined, outputPath: string, chunkSize: number, count: {
+    count: number;
+}): Promise<void>;
+//# sourceMappingURL=writeOutput.d.ts.map

package/dist/utils/writeOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeOutput.d.ts","sourceRoot":"","sources":["../../src/utils/writeOutput.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;GAUG;AAEH,wBAA8B,WAAW,CACrC,KAAK,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,SAAS,EACxC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/dist/utils/writeOutput.js

@@ -0,0 +1,56 @@
+import * as fs from "node:fs/promises";
+import outputFormatter from "./outputFormatter.js";
+/**
+ * Recursively adds content to the output files while ensuring
+ * that the size of each output file is less than the given chunkSize.
+ * If it is, it starts a new output file with the file namen given in
+ * outputPath. Stores the count as an object to have it persist.
+ *
+ * @param graph Project's graph
+ * @param outputPath The path to write output to
+ * @param chunkSize The max size of each output file
+ * @param count The count of the current output file
+ */
+export default async function writeOutput(graph, outputPath, chunkSize, count) {
+    // if graph is null/undefined, reach tip
+    if (!graph)
+        return;
+    // turn current node into array to handle empty directories
+    const nodes = Array.isArray(graph) ? graph : [graph];
+    // recursively adds each nodes' file content to the output
+    for (const node of nodes) {
+        if (node.type === "directory") {
+            await writeOutput(node.children, outputPath, chunkSize, count);
+        }
+        else if (node.type === "file") {
+            // get file's content and add formatting
+            const content = "*** " +
+                node.name +
+                " ***" +
+                "\n\n" +
+                (await fs.readFile(node.path)) +
+                "\n";
+            // get the correct output path 
+            let currentOutputPath = outputFormatter(outputPath, count.count);
+            // get the size of the current content
+            const contentSize = Buffer.byteLength(content, "utf-8");
+            // try-catch block because the currentOutputPath may not exist on disk
+            // ie. first time writing to this output file
+            try {
+                // get size of current output file
+                const { size } = await fs.stat(currentOutputPath);
+                // if the size of the current content is bigger
+                // than chunk size, skip file
+                if (contentSize > chunkSize)
+                    return;
+                // ensures that the chunkSize condition is respected
+                if (size > 0 && contentSize + size > chunkSize) {
+                    currentOutputPath = outputFormatter(outputPath, ++count.count);
+                }
+            }
+            catch (error) { }
+            await fs.writeFile(currentOutputPath, content, { flag: "a" });
+        }
+    }
+}
+//# sourceMappingURL=writeOutput.js.map

package/dist/utils/writeOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeOutput.js","sourceRoot":"","sources":["../../src/utils/writeOutput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,eAAe,MAAM,sBAAsB,CAAC;AAEnD;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,WAAW,CACrC,KAAwC,EACxC,UAAkB,EAClB,SAAiB,EACjB,KAAwB;IAExB,wCAAwC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,2DAA2D;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAErD,0DAA0D;IAC1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC5B,MAAM,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,wCAAwC;YACxC,MAAM,OAAO,GACT,MAAM;gBACN,IAAI,CAAC,IAAI;gBACT,MAAM;gBACN,MAAM;gBACN,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9B,IAAI,CAAC;YACT,+BAA+B;YAC/B,IAAI,iBAAiB,GAAG,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACjE,sCAAsC;YACtC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACxD,sEAAsE;YACtE,6CAA6C;YAC7C,IAAI,CAAC;gBACD,kCAAkC;gBAClC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAElD,+CAA+C;gBAC/C,6BAA6B;gBAC7B,IAAI,WAAW,GAAG,SAAS;oBAAE,OAAO;gBAEpC,oDAAoD;gBACpD,IAAI,IAAI,GAAG,CAAC,IAAI,WAAW,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC;oBAC7C,iBAAiB,GAAG,eAAe,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnE,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC,CAAA,CAAC;YAElB,MAAM,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAClE,CAAC;IACL,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+    "name": "ezctx",
+    "version": "1.0.0",
+    "description": "Puts all of your source code into one or several `.txt` file(s), allowing you to easily paste it into an external AI platform instead of having to tediously upload each individual file.",
+    "license": "MIT",
+    "author": "zye123",
+    "type": "module",
+    "main": "dist/index.ts",
+    "bin": "./dist/index.js",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/arhayashi/ezctx.git"
+    },
+    "homepage": "https://github.com/arhayashi/ezctx#readme",
+    "scripts": {
+        "ezctx": "npx tsc && node ./dist/index.js"
+    },
+    "devDependencies": {
+        "@types/node": "^24.10.1",
+        "typescript": "^5.9.3"
+    },
+    "keywords": [
+        "context",
+        "ai",
+        "bundler"
+    ],
+    "files": [
+        "/dist"
+    ]
+}