prodex 1.3.0 → 1.4.0

package/README.md

@@ -1,234 +1,234 @@
-# 🧩 Prodex v1.2.0
-
-> **Build the maze, I'll write a map.**
-
----
-
-## 🧠 What’s New — v1.2.0
-
-- 🆕 **Full CLI support with integrated [Sade](https://github.com/lukeed/sade).**  
-  Prodex now runs entirely from the terminal — no `prodex.json` required.  
-  Supports short flags and native glob patterns for flexible targeting.
-
-     ```bash
-     prodex -f "**/web.php,**/app.tsx" -i "**/*.d.ts" -x "node_modules/**"
-     ```
-
-     ```bash
-     prodex --files "**/web.php,**/app.tsx" --include **/*types.ts --exclude "@shadcn/**"
-     ```
-
-- 🧾 **Markdown mode added and now default.**  
-  Output is fully fenced and linkable — jump between the index and any code block.  
-  Text mode remains available using `--txt` or `-t`.
-
-- 🗂 **Output naming improved.**  
-  Output files are now versioned by default.  
-  Custom names are supported using `--name` or `-n`.  
-  Naming conventions have been updated for cleaner, consistent results.
-
----
-
-## ⚙️ Usage
-
-Prodex v1.2.0 runs entirely from the command line.  
-Interactive mode is currently unstable — use CLI flags instead.
-
-### Installation
-
-```bash
-npm install -g prodex
-```
-
-Or run without installing:
-
-```bash
-npx prodex
-```
-
----
-
-### Basic Run
-
-```bash
-prodex -f "**/web.php,**/app.tsx"
-```
-
-### With Includes, exclude, and Custom Name
-
-```bash
-prodex -f "**/web.php,**/app.tsx" -i "**/*.d.ts" -x "node_modules/**" -n "combined-output"
-```
-
-### Flag Reference
-
-| Flag        | Short | Description                                                                                                                                             |
-| ----------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `--files`   | `-f`  | Entry files — starting points for dependency resolution. Accepts multiple names or globs.                                                               |
-| `--include` | `-i`  | Adds extra files or patterns to include (e.g. `.d.ts`, interface, or type files). These files are **not dependency-resolved** — they’re appended as-is. |
-| `--exclude` | `-x`  | Patterns or folders to skip during the scan.                                                                                                            |
-| `--name`    | `-n`  | Custom output filename (without extension). Versioning still applies automatically.                                                                     |
-
-> Globs are powered by [Fast-Glob](https://github.com/mrmlnc/fast-glob).  
-> Use **comma-separated values** for multiple entries.  
-> Wrap globs in quotes when they include special characters like `|` or `&`.
-
----
-
-## 🧭 Plans
-
-- **Alias Resolution Improvements**  
-  Planned overhaul of alias handling to support deeper nested paths, wildcard matching, and auto-mapped imports across mixed stacks.
-
-- **Language Support**  
-  Currently supports **JavaScript**, **React**, and **Laravel + React** stacks.  
-  May work with other frameworks but remains untested.  
-  Broader multi-language support is planned for future versions.
-
-- **Combined Output**  
-  All code from multiple entries is merged into a single output file.  
-  There’s currently **no limit** on output size, but it’s advised to avoid combining _too many large entries_ in a single run.  
-  Future versions will include **smart naming** and **automatic splitting** for oversized outputs.
-
-- **Performance Optimizations**  
-  Planned improvements to resolver speed and dependency traversal for faster processing on large projects.
-
----
-
-## 🧩 Features
-
-| Status | Feature                     | Description                                                                                    |
-| :----: | --------------------------- | ---------------------------------------------------------------------------------------------- |
-|   ✅   | **Cross-language indexing** | Resolves imports across JS, TS, React, and PHP (Laravel) projects.                             |
-|   ✅   | **Markdown output**         | Generates clean `.md` files with anchors, back-to-top links, and fenced code blocks.           |
-|   ✅   | **Text output**             | Optional `.txt` mode using `--txt` or `-t`.                                                    |
-|   ✅   | **Glob support**            | Works with flexible glob patterns powered by [Fast-Glob](https://github.com/mrmlnc/fast-glob). |
-|   ✅   | **Custom output names**     | Define your own output prefix using `--name` or `-n`.                                          |
-|   ⚠️   | **Interactive picker (UI)** | Still unstable — not recommended for production use.                                           |
-|   ⚠️   | **Alias resolution**        | Basic alias mapping supported; advanced cases in progress.                                     |
-|   🚧   | **Smart file splitting**    | Planned for large combined outputs.                                                            |
-|   🚧   | **PSR-4 deep scan**         | Planned to improve PHP dependency resolution.                                                  |
-|   🚧   | **Speed optimization**      | Further resolver and I/O improvements under development.                                       |
-
----
-
-## 🧱 Use Cases
-
-Prodex can technically combine your entire codebase into one file —  
-but it’s **best used in parts**, focusing on specific sections or features.  
-Each run produces a clean, self-contained map showing all related files and dependencies.
-
-### 🧩 Common Scenarios
-
-- **🤖 Project Awareness for AI Assistants**  
-  Generate compact `.md` summaries of key parts of your project.  
-  These can be shared with AI tools (like ChatGPT, Claude, or Copilot) to give them structured context about your codebase — without exposing unnecessary files.
-
-- **📦 Feature or Module Mapping**  
-  Combine everything connected to a specific feature (e.g., `Checkout`, `Dashboard`, or `Payments`).  
-  Prodex gathers all linked imports, helpers, and files into one readable document.
-
-- **🔍 Dependency Insight**  
-  Trace how a particular entry file connects through your stack — whether it’s `app.tsx` on the frontend or `routes/web.php` on the backend.  
-  Great for debugging, refactoring, or understanding cross-stack dependencies.
-
-- **📖 Documentation Bundles**  
-  Create readable Markdown maps per module or domain instead of one large export.  
-  Each output acts as a focused, navigable view of your code relationships.
-
-- **🧠 Team Handoffs**  
-  Share isolated code scopes (like `Auth`, `Payments`, or `User Management`) with full dependency context.  
-  Makes onboarding and code reviews significantly faster.
-
----
-
-## 🧩 Recommended Workflow
-
-Prodex works best when used to **map and export projects in logical parts** rather than all at once.  
-Each run focuses on one or more entry points, and Prodex automatically **loads all imports recursively** for those files —  
-then appends any files matched by the `--include` flag.
-
-### 🧠 Suggested Pattern
-
-1. **Pick a meaningful entry file**  
-   Example:
-
-      - Frontend: `resources/js/**/dashboard.tsx`
-      - Backend: `routes/**/(web|api).php`
-      - Shared logic: `app/Services/**/PaymentService.php`
-
-2. **Run Prodex with includes for type or interface files**
-
-      ```bash
-      prodex -f "**/dashboard.tsx" -i "**/*.d.ts,**/*.interface.ts"
-      ```
-
-3. **Export separate maps for each major area**
-
-      ```bash
-      prodex -f "**/dashboard.tsx" -n "dashboard-map"
-      prodex -f "**/(web|api).php" -n "backend-map"
-      ```
-
-4. **Use them together**  
-   Store each output in `/prodex/`
-   These maps can be shared with teammates or loaded into AI tools for structured, code-aware assistance.
-
-> ⚡ Each run recursively resolves every import, applies includes, and outputs one complete dependency map for that section.
-
----
-
-## ⚙️ Optional — `prodex.json`
-
-`prodex.json` is **fully optional** in v1.2.0.  
-You can run Prodex entirely from the command line, but the config file can be useful for saved defaults.
-
-### 🪄 Quick Setup
-
-You can generate a ready-to-use config file with:
-
-```bash
-prodex init
-```
-
-This creates a `prodex.json` file in your project root with sensible defaults — including base directories, globs, and priority files.
-
-### 🧩 Running with a Config File
-
-If you’ve defined your entry files in the config under `entry.files`,  
-you can run Prodex directly without specifying `--files`:
-
-```bash
-prodex -c
-```
-
-The `-c` (or `--ci`) flag skips interactive mode and uses the config values automatically.  
-Specifying `-f` ( or `--files`) from the CLI also disables the picker by default.
-
-You can permanently disable the picker in the config by setting:
-
-```json
-"entry": {
-  "ui": {
-    "enablePicker": false
-  }
-}
-```
-
----
-
-## 📜 License
-
-**MIT License**  
-© 2025 [emxhive](https://github.com/emxhive)
-
----
-
-## ⚠️ Note from the Author
-
-Prodex is still a **work in progress**.  
-Some parts of the experience may be rough, especially around interactive mode and advanced resolvers.  
-Updates are released **multiple times per week — sometimes daily** — to keep improving stability and support.
-
-Please stay up to date for the best experience.  
-Thank you for testing Prodex early. ❤️
+# 🧩 Prodex v1.2.0
+
+> **Build the maze, I'll write a map.**
+
+---
+
+## 🧠 What’s New — v1.2.0
+
+- 🆕 **Full CLI support with integrated [Sade](https://github.com/lukeed/sade).**  
+  Prodex now runs entirely from the terminal — no `prodex.json` required.  
+  Supports short flags and native glob patterns for flexible targeting.
+
+     ```bash
+     prodex -f "**/web.php,**/app.tsx" -i "**/*.d.ts" -x "node_modules/**"
+     ```
+
+     ```bash
+     prodex --files "**/web.php,**/app.tsx" --include **/*types.ts --exclude "@shadcn/**"
+     ```
+
+- 🧾 **Markdown mode added and now default.**  
+  Output is fully fenced and linkable — jump between the index and any code block.  
+  Text mode remains available using `--txt` or `-t`.
+
+- 🗂 **Output naming improved.**  
+  Output files are now versioned by default.  
+  Custom names are supported using `--name` or `-n`.  
+  Naming conventions have been updated for cleaner, consistent results.
+
+---
+
+## ⚙️ Usage
+
+Prodex v1.2.0 runs entirely from the command line.  
+Interactive mode is currently unstable — use CLI flags instead.
+
+### Installation
+
+```bash
+npm install -g prodex
+```
+
+Or run without installing:
+
+```bash
+npx prodex
+```
+
+---
+
+### Basic Run
+
+```bash
+prodex -f "**/web.php,**/app.tsx"
+```
+
+### With Includes, exclude, and Custom Name
+
+```bash
+prodex -f "**/web.php,**/app.tsx" -i "**/*.d.ts" -x "node_modules/**" -n "combined-output"
+```
+
+### Flag Reference
+
+| Flag        | Short | Description                                                                                                                                             |
+| ----------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--files`   | `-f`  | Entry files — starting points for dependency resolution. Accepts multiple names or globs.                                                               |
+| `--include` | `-i`  | Adds extra files or patterns to include (e.g. `.d.ts`, interface, or type files). These files are **not dependency-resolved** — they’re appended as-is. |
+| `--exclude` | `-x`  | Patterns or folders to skip during the scan.                                                                                                            |
+| `--name`    | `-n`  | Custom output filename (without extension). Versioning still applies automatically.                                                                     |
+
+> Globs are powered by [Fast-Glob](https://github.com/mrmlnc/fast-glob).  
+> Use **comma-separated values** for multiple entries.  
+> Wrap globs in quotes when they include special characters like `|` or `&`.
+
+---
+
+## 🧭 Plans
+
+- **Alias Resolution Improvements**  
+  Planned overhaul of alias handling to support deeper nested paths, wildcard matching, and auto-mapped imports across mixed stacks.
+
+- **Language Support**  
+  Currently supports **JavaScript**, **React**, and **Laravel + React** stacks.  
+  May work with other frameworks but remains untested.  
+  Broader multi-language support is planned for future versions.
+
+- **Combined Output**  
+  All code from multiple entries is merged into a single output file.  
+  There’s currently **no limit** on output size, but it’s advised to avoid combining _too many large entries_ in a single run.  
+  Future versions will include **smart naming** and **automatic splitting** for oversized outputs.
+
+- **Performance Optimizations**  
+  Planned improvements to resolver speed and dependency traversal for faster processing on large projects.
+
+---
+
+## 🧩 Features
+
+| Status | Feature                     | Description                                                                                    |
+| :----: | --------------------------- | ---------------------------------------------------------------------------------------------- |
+|   ✅   | **Cross-language indexing** | Resolves imports across JS, TS, React, and PHP (Laravel) projects.                             |
+|   ✅   | **Markdown output**         | Generates clean `.md` files with anchors, back-to-top links, and fenced code blocks.           |
+|   ✅   | **Text output**             | Optional `.txt` mode using `--txt` or `-t`.                                                    |
+|   ✅   | **Glob support**            | Works with flexible glob patterns powered by [Fast-Glob](https://github.com/mrmlnc/fast-glob). |
+|   ✅   | **Custom output names**     | Define your own output prefix using `--name` or `-n`.                                          |
+|   ⚠️   | **Interactive picker (UI)** | Still unstable — not recommended for production use.                                           |
+|   ⚠️   | **Alias resolution**        | Basic alias mapping supported; advanced cases in progress.                                     |
+|   🚧   | **Smart file splitting**    | Planned for large combined outputs.                                                            |
+|   🚧   | **PSR-4 deep scan**         | Planned to improve PHP dependency resolution.                                                  |
+|   🚧   | **Speed optimization**      | Further resolver and I/O improvements under development.                                       |
+
+---
+
+## 🧱 Use Cases
+
+Prodex can technically combine your entire codebase into one file —  
+but it’s **best used in parts**, focusing on specific sections or features.  
+Each run produces a clean, self-contained map showing all related files and dependencies.
+
+### 🧩 Common Scenarios
+
+- **🤖 Project Awareness for AI Assistants**  
+  Generate compact `.md` summaries of key parts of your project.  
+  These can be shared with AI tools (like ChatGPT, Claude, or Copilot) to give them structured context about your codebase — without exposing unnecessary files.
+
+- **📦 Feature or Module Mapping**  
+  Combine everything connected to a specific feature (e.g., `Checkout`, `Dashboard`, or `Payments`).  
+  Prodex gathers all linked imports, helpers, and files into one readable document.
+
+- **🔍 Dependency Insight**  
+  Trace how a particular entry file connects through your stack — whether it’s `app.tsx` on the frontend or `routes/web.php` on the backend.  
+  Great for debugging, refactoring, or understanding cross-stack dependencies.
+
+- **📖 Documentation Bundles**  
+  Create readable Markdown maps per module or domain instead of one large export.  
+  Each output acts as a focused, navigable view of your code relationships.
+
+- **🧠 Team Handoffs**  
+  Share isolated code scopes (like `Auth`, `Payments`, or `User Management`) with full dependency context.  
+  Makes onboarding and code reviews significantly faster.
+
+---
+
+## 🧩 Recommended Workflow
+
+Prodex works best when used to **map and export projects in logical parts** rather than all at once.  
+Each run focuses on one or more entry points, and Prodex automatically **loads all imports recursively** for those files —  
+then appends any files matched by the `--include` flag.
+
+### 🧠 Suggested Pattern
+
+1. **Pick a meaningful entry file**  
+   Example:
+
+      - Frontend: `resources/js/**/dashboard.tsx`
+      - Backend: `routes/**/(web|api).php`
+      - Shared logic: `app/Services/**/PaymentService.php`
+
+2. **Run Prodex with includes for type or interface files**
+
+      ```bash
+      prodex -f "**/dashboard.tsx" -i "**/*.d.ts,**/*.interface.ts"
+      ```
+
+3. **Export separate maps for each major area**
+
+      ```bash
+      prodex -f "**/dashboard.tsx" -n "dashboard-map"
+      prodex -f "**/(web|api).php" -n "backend-map"
+      ```
+
+4. **Use them together**  
+   Store each output in `/prodex/`
+   These maps can be shared with teammates or loaded into AI tools for structured, code-aware assistance.
+
+> ⚡ Each run recursively resolves every import, applies includes, and outputs one complete dependency map for that section.
+
+---
+
+## ⚙️ Optional — `prodex.json`
+
+`prodex.json` is **fully optional** in v1.2.0.  
+You can run Prodex entirely from the command line, but the config file can be useful for saved defaults.
+
+### 🪄 Quick Setup
+
+You can generate a ready-to-use config file with:
+
+```bash
+prodex init
+```
+
+This creates a `prodex.json` file in your project root with sensible defaults — including base directories, globs, and priority files.
+
+### 🧩 Running with a Config File
+
+If you’ve defined your entry files in the config under `entry.files`,  
+you can run Prodex directly without specifying `--files`:
+
+```bash
+prodex -c
+```
+
+The `-c` (or `--ci`) flag skips interactive mode and uses the config values automatically.  
+Specifying `-f` ( or `--files`) from the CLI also disables the picker by default.
+
+You can permanently disable the picker in the config by setting:
+
+```json
+"entry": {
+  "ui": {
+    "enablePicker": false
+  }
+}
+```
+
+---
+
+## 📜 License
+
+**MIT License**  
+© 2025 [emxhive](https://github.com/emxhive)
+
+---
+
+## ⚠️ Note from the Author
+
+Prodex is still a **work in progress**.  
+Some parts of the experience may be rough, especially around interactive mode and advanced resolvers.  
+Updates are released **multiple times per week — sometimes daily** — to keep improving stability and support.
+
+Please stay up to date for the best experience.  
+Thank you for testing Prodex early. ❤️

package/dist/cli/cli-input.js

@@ -5,24 +5,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseCliInput = parseCliInput;
 const sade_1 = __importDefault(require("sade"));
-const flags_1 = require("./flags");
-const logger_1 = require("../lib/logger");
 const path_1 = __importDefault(require("path"));
 const package_json_1 = __importDefault(require("../../package.json"));
 const fs_1 = __importDefault(require("fs"));
+const flags_1 = require("../constants/flags");
 /**
- * Unified CLI parser powered by Sade.
- * Returns { root, entries (from --files), flags, warnings, errors }.
+ * Unified CLI parser powered by Sade and FLAG_MAP.
+ * Returns { root, flags, warnings, errors }.
  */
 function parseCliInput(argv = process.argv) {
     if (argv.includes("-v") || argv.includes("--version")) {
-        logger_1.logger.log(`prodex v${package_json_1.default.version}`);
+        console.log(`prodex v${package_json_1.default.version}`);
         process.exit(0);
     }
     const program = (0, sade_1.default)("prodex [root]");
     registerFlags(program);
     let parsed = { rootArg: "", root: undefined, flags: {} };
-    // Define action
     program.action((root, opts) => {
         const cwd = process.cwd();
         parsed = {
@@ -34,31 +32,22 @@ function parseCliInput(argv = process.argv) {
     program.parse(argv);
     const warnings = [];
     const errors = [];
-    // Post-parse casting + normalization
     parsed.flags = normalizeFlags(parsed.flags, warnings, errors);
     validateArgs(parsed, warnings, errors);
-    return {
-        ...parsed,
-        warnings,
-        errors,
-    };
+    return { ...parsed, warnings, errors };
 }
 function registerFlags(program) {
-    for (const [key, meta] of Object.entries(flags_1.PRODEX_FLAGS)) {
+    for (const [key, meta] of Object.entries(flags_1.FLAG_MAP)) {
         const short = meta.short ? `-${meta.short}, ` : "";
         const long = `--${key}`;
         const desc = meta.description;
-        let defaultVal;
-        if (meta.type === "boolean")
-            defaultVal = false;
-        if (defaultVal !== undefined)
-            program.option(`${short}${long}`, desc, defaultVal);
-        else
-            program.option(`${short}${long}`, desc);
+        const defaultVal = meta.type === "boolean" ? false : undefined;
+        program.option(`${short}${long}`, desc, defaultVal);
     }
 }
+/** Convert flag values to correct types based on FLAG_MAP metadata. */
 function normalizeFlags(flags, warnings, errors) {
-    for (const [key, meta] of Object.entries(flags_1.PRODEX_FLAGS)) {
+    for (const [key, meta] of Object.entries(flags_1.FLAG_MAP)) {
         const raw = flags[key];
         if (raw === undefined)
             continue;
@@ -72,19 +61,23 @@ function normalizeFlags(flags, warnings, errors) {
                 break;
             }
             case "list": {
-                const arr = String(raw)
+                flags[key] = String(raw)
                     .split(",")
                     .map((v) => v.trim())
                     .filter(Boolean);
-                flags[key] = arr;
                 break;
             }
+            default: {
+                if (meta.type === "string")
+                    flags[key] = String(raw);
+            }
         }
     }
     return flags;
 }
+/** Validate path argument and report unrecognized flags. */
 function validateArgs(parsed, warnings, errors) {
-    const { rootArg, flags: { _: unknown }, } = parsed;
+    const { rootArg } = parsed;
     if (rootArg) {
         if (!fs_1.default.existsSync(parsed.root)) {
             errors.push(`Invalid path argument: "${rootArg}" does not exist.`);
@@ -93,14 +86,16 @@ function validateArgs(parsed, warnings, errors) {
             errors.push(`Path argument "${rootArg}" is not a directory.`);
         }
     }
+    const unknown = parsed.flags?._ || [];
     if (unknown.length) {
         warnings.push(`Unrecognized arguments detected [${unknown.join(", ")}]- They were ignored.`);
     }
     if (warnings.length)
-        logger_1.logger.warn("Warnings:", warnings);
+        console.warn("Warnings:", warnings);
     if (errors.length) {
         for (const err of errors)
-            logger_1.logger.error(err);
+            console.error(err);
         process.exit(1);
     }
 }
+//# sourceMappingURL=cli-input.js.map

package/dist/cli/cli-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-input.js","sourceRoot":"","sources":["../../src/cli/cli-input.ts"],"names":[],"mappings":"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","sourcesContent":["import sade from \"sade\";\nimport path from \"path\";\nimport pkg from \"../../package.json\";\nimport fs from \"fs\";\nimport { FLAG_MAP } from \"../constants/flags\";\nimport type { ParsedInput } from \"../types\";\n\n/**\n * Unified CLI parser powered by Sade and FLAG_MAP.\n * Returns { root, flags, warnings, errors }.\n */\nexport function parseCliInput(argv: string[] = process.argv) {\n\tif (argv.includes(\"-v\") || argv.includes(\"--version\")) {\n\t\tconsole.log(`prodex v${pkg.version}`);\n\t\tprocess.exit(0);\n\t}\n\n\tconst program = sade(\"prodex [root]\");\n\tregisterFlags(program);\n\n\tlet parsed: ParsedInput = { rootArg: \"\", root: undefined, flags: {} };\n\n\tprogram.action((root: string | undefined, opts: Record<string, any>) => {\n\t\tconst cwd = process.cwd();\n\t\tparsed = {\n\t\t\trootArg: root,\n\t\t\troot: root ? path.resolve(cwd, root) : cwd,\n\t\t\tflags: { ...opts },\n\t\t};\n\t});\n\n\tprogram.parse(argv);\n\n\tconst warnings: string[] = [];\n\tconst errors: string[] = [];\n\n\tparsed.flags = normalizeFlags(parsed.flags, warnings, errors);\n\tvalidateArgs(parsed, warnings, errors);\n\n\treturn { ...parsed, warnings, errors };\n}\n\nfunction registerFlags(program: ReturnType<typeof sade>) {\n\tfor (const [key, meta] of Object.entries(FLAG_MAP)) {\n\t\tconst short = meta.short ? `-${meta.short}, ` : \"\";\n\t\tconst long = `--${key}`;\n\t\tconst desc = meta.description;\n\t\tconst defaultVal = meta.type === \"boolean\" ? false : undefined;\n\t\tprogram.option(`${short}${long}`, desc, defaultVal);\n\t}\n}\n\n/** Convert flag values to correct types based on FLAG_MAP metadata. */\nfunction normalizeFlags(flags: Record<string, any>, warnings: string[], errors: string[]) {\n\tfor (const [key, meta] of Object.entries(FLAG_MAP)) {\n\t\tconst raw = flags[key];\n\t\tif (raw === undefined) continue;\n\n\t\tswitch (meta.type) {\n\t\t\tcase \"number\": {\n\t\t\t\tconst num = Number(raw);\n\t\t\t\tif (Number.isNaN(num)) errors.push(`Flag --${key} expected a number but got \"${raw}\"`);\n\t\t\t\telse flags[key] = num;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"list\": {\n\t\t\t\tflags[key] = String(raw)\n\t\t\t\t\t.split(\",\")\n\t\t\t\t\t.map((v) => v.trim())\n\t\t\t\t\t.filter(Boolean);\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tdefault: {\n\t\t\t\tif (meta.type === \"string\") flags[key] = String(raw);\n\t\t\t}\n\t\t}\n\t}\n\treturn flags;\n}\n\n/** Validate path argument and report unrecognized flags. */\nfunction validateArgs(parsed: ParsedInput, warnings: string[], errors: string[]) {\n\tconst { rootArg } = parsed;\n\n\tif (rootArg) {\n\t\tif (!fs.existsSync(parsed.root)) {\n\t\t\terrors.push(`Invalid path argument: \"${rootArg}\" does not exist.`);\n\t\t} else if (!fs.statSync(parsed.root).isDirectory()) {\n\t\t\terrors.push(`Path argument \"${rootArg}\" is not a directory.`);\n\t\t}\n\t}\n\n\tconst unknown = parsed.flags?._ || [];\n\tif (unknown.length) {\n\t\twarnings.push(`Unrecognized arguments detected [${unknown.join(\", \")}]- They were ignored.`);\n\t}\n\n\tif (warnings.length) console.warn(\"Warnings:\", warnings);\n\tif (errors.length) {\n\t\tfor (const err of errors) console.error(err);\n\t\tprocess.exit(1);\n\t}\n}\n"]}

package/dist/cli/flags.js

@@ -40,3 +40,4 @@ Usage: prodex [-fcdv]
        [--limit=<int>|-l=<int>]
        [--help|-h]
 `;
+//# sourceMappingURL=flags.js.map

package/dist/cli/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/cli/flags.ts"],"names":[],"mappings":";;;AAMA,IAAY,OAUX;AAVD,WAAY,OAAO;IAClB,sBAAW,CAAA;IACX,oBAAS,CAAA;IACT,0BAAe,CAAA;IACf,wBAAa,CAAA;IACb,0BAAe,CAAA;IACf,0BAAe,CAAA;IACf,0BAAe,CAAA;IACf,wBAAa,CAAA;IACb,0BAAe,CAAA;AAChB,CAAC,EAVW,OAAO,uBAAP,OAAO,QAUlB;AAOY,QAAA,YAAY,GAA0B;IAClD,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,8BAA8B,EAAE;IAC1F,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC7F,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sBAAsB,EAAE;IAClF,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE;IACnF,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;IACtF,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;IACzF,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC1F,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC1F,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE;CACvF,CAAC;AAEF,wCAAwC;AAC3B,QAAA,cAAc,GAA4B,MAAM,CAAC,OAAO,CAAC,oBAAY,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;IAC/G,IAAI,IAAI,CAAC,KAAK;QAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAc,CAAC;IACjD,OAAO,GAAG,CAAC;AACZ,CAAC,EAAE,EAA6B,CAAC,CAAC;AAGrB,QAAA,SAAS,GAAG;;;;;;;;;CASxB,CAAC","sourcesContent":["/**\n * 🧩 Prodex Flag Definitions (v3)\n * Metadata used by the CLI parser for validation, casting, and help output.\n */\nexport type FlagType = \"boolean\" | \"string\" | \"number\" | \"list\";\n\nexport enum FlagKey {\n\tTxt = \"txt\",\n\tCi = \"ci\",\n\tDebug = \"debug\",\n\tName = \"name\",\n\tLimit = \"limit\",\n\tInc = \"include\",\n\tExc = \"exclude\",\n\tHelp = \"help\",\n\tFiles = \"files\",\n}\n\ntype Spec = {\n\tshort?: string;\n\ttype: FlagType;\n\tdescription: string;\n};\nexport const PRODEX_FLAGS: Record<FlagKey, Spec> = {\n\t[FlagKey.Files]: { short: \"f\", type: \"list\", description: \"Comma-separated entry files.\" },\n\t[FlagKey.Txt]: { short: \"t\", type: \"boolean\", description: \"Output as .txt instead of .md.\" },\n\t[FlagKey.Ci]: { short: \"c\", type: \"boolean\", description: \"Headless/no-UI mode.\" },\n\t[FlagKey.Debug]: { short: \"d\", type: \"boolean\", description: \"Enable debug logs.\" },\n\t[FlagKey.Name]: { short: \"n\", type: \"string\", description: \"Custom output filename.\" },\n\t[FlagKey.Limit]: { short: \"l\", type: \"number\", description: \"Override traversal limit.\" },\n\t[FlagKey.Inc]: { type: \"list\", short: \"i\", description: \"Comma-separated include globs.\" },\n\t[FlagKey.Exc]: { type: \"list\", short: \"x\", description: \"Comma-separated exclude globs.\" },\n\t[FlagKey.Help]: { short: \"h\", type: \"boolean\", description: \"Show CLI help and exit.\" },\n};\n\n/** Reverse lookup for short aliases. */\nexport const FLAG_SHORT_MAP: Record<string, FlagKey> = Object.entries(PRODEX_FLAGS).reduce((acc, [key, meta]) => {\n\tif (meta.short) acc[meta.short] = key as FlagKey;\n\treturn acc;\n}, {} as Record<string, FlagKey>);\n\n\nexport const CLI_USAGE = `\nUsage: prodex [-fcdv]\n       [--files=<globs>|-f=<globs>]\n       [--include=<globs>|-i=<globs>]\n       [--exclude=<globs>|-x=<globs>]\n       [--txt|-t] [--ci|-c] [--debug|-d] [--version|-v]\n       [--name=<string>|-n=<string>]\n       [--limit=<int>|-l=<int>]\n       [--help|-h]\n`;\n"]}

package/dist/cli/init.js

@@ -7,15 +7,15 @@ exports.initProdex = initProdex;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const default_config_1 = require("../constants/default-config");
-const logger_1 = require("../lib/logger");
 async function initProdex() {
-    logger_1.logger.log("🪄 Prodex Init — Configuration Wizard (v2)");
+    console.log("🪄 Prodex Init — Configuration Wizard (v3");
     const dest = path_1.default.join(process.cwd(), "prodex.json");
     if (fs_1.default.existsSync(dest)) {
-        logger_1.logger.error("prodex.json already exists. Delete or modify it manually.\n");
+        console.error("prodex.json already exists. Delete or modify it manually.\n");
         return;
     }
     fs_1.default.writeFileSync(dest, JSON.stringify(default_config_1.DEFAULT_PRODEX_CONFIG, null, 2) + "\n", "utf8");
-    logger_1.logger.log(`✅ Created ${dest}`);
-    logger_1.logger.log("💡 Globs supported everywhere (include, exclude, priority).");
+    console.log(`✅ Created ${dest}`);
+    console.log("💡 Globs supported everywhere (include, exclude, priority).");
 }
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":";;;;;AAIA,gCAaC;AAjBD,4CAAoB;AACpB,gDAAwB;AACxB,gEAAoE;AAE7D,KAAK,UAAU,UAAU;IAC/B,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IAEzD,MAAM,IAAI,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAC;IAErD,IAAI,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC7E,OAAO;IACR,CAAC;IAED,YAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,sCAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;AAC5E,CAAC","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport { DEFAULT_PRODEX_CONFIG } from \"../constants/default-config\";\n\nexport async function initProdex() {\n\tconsole.log(\"🪄 Prodex Init — Configuration Wizard (v3\");\n\n\tconst dest = path.join(process.cwd(), \"prodex.json\");\n\n\tif (fs.existsSync(dest)) {\n\t\tconsole.error(\"prodex.json already exists. Delete or modify it manually.\\n\");\n\t\treturn;\n\t}\n\n\tfs.writeFileSync(dest, JSON.stringify(DEFAULT_PRODEX_CONFIG, null, 2) + \"\\n\", \"utf8\");\n\tconsole.log(`✅ Created ${dest}`);\n\tconsole.log(\"💡 Globs supported everywhere (include, exclude, priority).\");\n}\n"]}