prodex 1.4.1 → 1.4.5

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

@@ -22,10 +22,15 @@ function parseCliInput(argv = process.argv) {
     registerFlags(program);
     let parsed = { rootArg: "", root: undefined, flags: {} };
     program.action((root, opts) => {
+        let lroot = root;
         const cwd = process.cwd();
+        if (root?.startsWith("@")) {
+            opts.shortcut = root.slice(1).trim();
+            lroot = undefined;
+        }
         parsed = {
-            rootArg: root,
-            root: root ? path_1.default.resolve(cwd, root) : cwd,
+            rootArg: lroot,
+            root: lroot ? path_1.default.resolve(cwd, lroot) : cwd,
             flags: { ...opts },
         };
     });

package/dist/cli/init.js

@@ -7,6 +7,7 @@ exports.initProdex = initProdex;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const default_config_1 = require("../constants/default-config");
+const utils_1 = require("../lib/utils");
 async function initProdex() {
     console.log("🪄 Prodex Init — Configuration Wizard (v3");
     const dest = path_1.default.join(process.cwd(), "prodex.json");
@@ -14,7 +15,7 @@ async function initProdex() {
         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");
+    fs_1.default.writeFileSync(dest, (0, utils_1.toJson)(default_config_1.DEFAULT_PRODEX_CONFIG) + "\n", "utf8");
     console.log(`✅ Created ${dest}`);
     console.log("💡 Globs supported everywhere (include, exclude, priority).");
 }

package/dist/constants/config.js

@@ -24,4 +24,4 @@ exports.SUFFIX = "trace";
  * - Trims and removes empty elements.
  * - Filters out invalid or unusable characters for Fast-Glob.
  */
-exports.VALID_GLOB_CHARS = /^[\w\-@./*?|!{}\[\]^$()+]+$/; // allows Fast-Glob-safe symbolsexport const REAL_EXTS = new Set<string>([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".d.ts", ".json"]);
+exports.VALID_GLOB_CHARS = /^[\w\-@./*?|!{}\[\]^$()+]+$/;

package/dist/constants/default-config.js

@@ -7,6 +7,7 @@ exports.DEFAULT_PRODEX_CONFIG = void 0;
  */
 exports.DEFAULT_PRODEX_CONFIG = {
     version: 3.1,
+    $schema: "https://raw.githubusercontent.com/emxhive/prodex/main/schema/prodex.schema.json",
     output: {
         dir: "prodex",
         versioned: true,
@@ -18,17 +19,25 @@ exports.DEFAULT_PRODEX_CONFIG = {
         ui: {
             roots: ["app", "routes", "resources/js/**"],
             scanDepth: 2,
-            priority: ["**/routes/web.php", "**/routes/api.php", "**/*index.*", "**/*main.*", "**/app.*"],
+            priority: ["**/routes/web.php", "**/app.*"],
         },
     },
     resolve: {
-        include: ["**/*.d.ts", "**/*.interface.ts"],
+        include: ["**/*.d.ts"],
         aliases: {
-            "@hooks": "resources/js/hooks",
-            "@data": "resources/js/data",
+            "@": "resources/js",
         },
         exclude: ["node_modules/**", "@shadcn/**", "**/components/ui/**"],
         depth: 10,
         limit: 200,
     },
+    shortcuts: {
+        dashboard: {
+            files: ["**/dashboard.tsx"],
+            include: ["**.app.tsx", "**/*.d.ts"],
+        },
+        web: {
+            files: ["**/web.php", "**/api.php"],
+        },
+    },
 };

package/dist/constants/flags.js

@@ -50,6 +50,12 @@ exports.FLAG_MAP = {
         description: "Enable debug logs.",
         apply: () => { },
     },
+    shortcut: {
+        short: "a",
+        type: "string",
+        description: "Apply a config shortcut by name.",
+        apply: () => { },
+    },
     help: {
         short: "h",
         type: "boolean",

package/dist/core/managers/config.js

@@ -15,12 +15,15 @@ const store_1 = require("../../store");
  * Unified loader, merger, and flag applier.
  */
 class ConfigManager {
+    static rawFile = null;
     static load(cwd) {
         const file = path_1.default.join(cwd, "prodex.json");
         if (!fs_1.default.existsSync(file))
             return default_config_1.DEFAULT_PRODEX_CONFIG;
         try {
-            return JSON.parse(fs_1.default.readFileSync(file, "utf8"));
+            const parsed = JSON.parse(fs_1.default.readFileSync(file, "utf8"));
+            this.rawFile = parsed; // <-- SAVE RAW COPY
+            return parsed;
         }
         catch {
             console.warn("⚠️ Invalid prodex.json — using defaults.");
@@ -29,7 +32,7 @@ class ConfigManager {
     }
     static merge(user, flags, cwd = process.cwd()) {
         const merged = {
-            ...default_config_1.DEFAULT_PRODEX_CONFIG,
+            // ...rest,
             ...user,
             output: { ...default_config_1.DEFAULT_PRODEX_CONFIG.output, ...user.output },
             entry: {
@@ -57,6 +60,34 @@ class ConfigManager {
         const hasFiles = Array.isArray(flags.files) ? flags.files.length > 0 : !!flags.files;
         if (hasFiles && !flags.include)
             cfg.resolve.include = [];
+        if (flags.shortcut && cfg.shortcuts && cfg.shortcuts[flags.shortcut])
+            return this.applyShortcuts(cfg, flags);
+        return cfg;
+    }
+    static applyShortcuts(cfg, flags) {
+        const shortcut = cfg.shortcuts?.[flags.shortcut];
+        if (!shortcut)
+            return cfg;
+        const mergeOrReplace = (key, target) => {
+            const flagValues = (flags[key] || []);
+            const hasFlags = !(0, utils_1.ArrisEmpty)(flagValues);
+            let values = shortcut[key];
+            if (!values && !hasFlags) {
+                target[key] = [];
+                return;
+            }
+            if (!values)
+                values = [];
+            target[key] = hasFlags ? [...flagValues, ...values] : values;
+        };
+        // include / exclude live in cfg.resolve
+        mergeOrReplace("include", cfg.resolve);
+        mergeOrReplace("exclude", cfg.resolve);
+        // files live in cfg.entry
+        mergeOrReplace("files", cfg.entry);
+        // name override
+        if (shortcut.prefix)
+            cfg.name = shortcut.prefix;
         return cfg;
     }
     static normalize(cfg) {
@@ -69,11 +100,14 @@ class ConfigManager {
     static persist(partial) {
         const cfg = (0, store_1.getConfig)();
         const dest = path_1.default.join(cfg.root, "prodex.json");
-        const { root, name, ...pure } = cfg;
-        const merged = deepMerge(pure, partial);
+        // Start from the raw config, never the merged runtime version
+        const base = ConfigManager.rawFile
+            ? JSON.parse(JSON.stringify(ConfigManager.rawFile)) // deep clone to avoid mutation
+            : {};
+        // Apply only the partial updates (aliases, etc.)
+        const patched = deepMerge(base, partial);
         try {
-            fs_1.default.writeFileSync(dest, JSON.stringify(merged, null, 2) + "\n", "utf8");
-            console.log(`✅ Updated ${dest}`);
+            fs_1.default.writeFileSync(dest, (0, utils_1.toJson)(patched) + "\n", "utf8");
         }
         catch (err) {
             console.warn("⚠️ Failed to persist config:", err?.message || err);

package/dist/debug.js

@@ -4,9 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const index_1 = __importDefault(require("./index"));
+require("source-map-support/register");
 (async () => {
-    const mockArgs = ["node", "prodex", "C:\\Users\\USER\\Herd\\fireshot", "-f", "**/(dashboard|accounts).tsx", "-cd"];
+    const mockArgs = ["node", "prodex", "@web", "-cd"];
     process.argv = mockArgs;
+    //"-f", "**/(dashboard|accounts).tsx",
     console.log("🧩 Debug runner starting...");
     await (0, index_1.default)();
     console.log("🧩 Debug runner done.");

package/dist/index.js

@@ -47,7 +47,7 @@ async function startProdex(args = process.argv) {
     const config = config_1.ConfigManager.merge(userConfig, flags, root);
     (0, store_1.setGlobals)(config, flags);
     const opts = {
-        showUi: !flags.ci && !flags?.files?.length && !config?.entry?.ui?.enablePicker,
+        showUi: !flags.ci && !flags?.files?.length && config?.entry?.ui?.enablePicker && !flags.shortcut,
         cliName: config.name,
     };
     await Promise.resolve().then(() => __importStar(require("./lib/polyfills")));

package/dist/lib/utils.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.shortTimestamp = shortTimestamp;
 exports.normalizePatterns = normalizePatterns;
+exports.ArrisEmpty = ArrisEmpty;
+exports.toJson = toJson;
 const config_1 = require("../constants/config");
 /** Compact YYMMDD-HHmm timestamp for versioned filenames. */
 function shortTimestamp() {
@@ -36,3 +38,9 @@ function normalizePatterns(input) {
         return valid;
     });
 }
+function ArrisEmpty(arr) {
+    return !arr || Array.isArray(arr) && arr.length === 0;
+}
+function toJson(obj) {
+    return JSON.stringify(obj, null, 4);
+}

package/dist/resolvers/js/js-resolver.js

@@ -36,8 +36,7 @@ async function resolveJsImports({ filePath, visited = new Set(), depth = 0, maxD
     if (!imports.size)
         return (0, collections_1.emptyResult)(visited);
     // Trackers ----------------------------------------------
-    const expected = new Set();
-    const resolved = new Set();
+    const stats = (0, collections_1.newStats)();
     const files = [];
     // Main resolution loop ----------------------------------
     for (const imp of imports) {
@@ -62,11 +61,17 @@ async function resolveJsImports({ filePath, visited = new Set(), depth = 0, maxD
         if (!base)
             continue;
         const absBase = path_1.default.resolve(base);
-        expected.add(absBase);
+        // Exclusion check after alias resolution
+        if ((0, shared_1.isExcluded)(absBase, excludePatterns))
+            continue;
         const resolvedPath = await tryResolveImport(absBase);
+        // Exclusion check after final resolution
+        if ((0, shared_1.isExcluded)(resolvedPath, excludePatterns))
+            continue;
+        stats.expected.add(absBase);
         if (!resolvedPath)
             continue;
-        resolved.add(absBase);
+        stats.resolved.add(absBase);
         files.push(resolvedPath);
         // Recursive traversal
         const sub = await resolveJsImports({
@@ -76,17 +81,14 @@ async function resolveJsImports({ filePath, visited = new Set(), depth = 0, maxD
             maxDepth: limitDepth,
         });
         files.push(...sub.files);
-        for (const e of sub.stats.expected)
-            expected.add(e);
-        for (const r of sub.stats.resolved)
-            resolved.add(r);
+        (0, collections_1.mergeStats)(stats, sub.stats);
     }
     const uniqueFiles = (0, collections_1.unique)(files);
-    const diff = (0, shared_2.setDiff)(expected, resolved);
-    logger_1.logger.debug(`🪶 [js-resolver] ${filePath} → expected: ${expected.size}, resolved: ${resolved.size}`);
+    const diff = (0, shared_2.setDiff)(stats.expected, stats.resolved);
+    logger_1.logger.debug(`🪶 [js-resolver] ${filePath} → expected: ${stats.expected.size}, resolved: ${stats.resolved.size}`);
     if (diff.size)
         logger_1.logger.debug([...diff], "🔴 THE diff");
-    return { files: uniqueFiles, visited, stats: { expected, resolved } };
+    return { files: uniqueFiles, visited, stats };
 }
 // ---------------------------------------------------------
 // tryResolveImport (pure)

package/dist/resolvers/js/resolve-alias.js

@@ -8,6 +8,7 @@ const path_1 = __importDefault(require("path"));
 const cache_1 = require("../../core/managers/cache");
 const constants_1 = require("../../constants");
 const helpers_1 = require("../../core/helpers");
+const shared_1 = require("../../shared");
 /**
  * 🧩 resolveAliasPath()
  * Unifies alias lookup across config, cache, and fallback discovery.
@@ -39,19 +40,21 @@ async function resolveAliasPath(specifier, root, cfg) {
     const hasExt = /\.[a-z0-9]+$/i.test(stripped);
     const patterns = hasExt ? [`**/${stripped}`] : [`**/${stripped}.*`, `**/${stripped}/index.*`];
     const { files: matches } = await (0, helpers_1.globScan)(patterns, { cwd: root });
-    if (matches.length === 1) {
-        return resolveMatches(matches, remainder, aliasKey);
-    }
-    //There are multiple matches, Assuming they match the target approximate folder.
-    if (matches.length > 1) {
-        const resolvedMatch = resolveMatches(matches, remainder, aliasKey);
-        return resolvedMatch.replace(/\.[^/.]+$/, "");
+    if (matches.length) {
+        const resolvedMatch = resolveMatches(matches, remainder);
+        // .replace(/\.[^/.]+$/, "")
+        if (!resolvedMatch)
+            return null;
+        const relPath = (0, shared_1.rel)(resolvedMatch, cfg.root);
+        cache_1.CacheManager.set(constants_1.CACHE_KEYS.ALIASES, aliasKey, relPath);
+        return relPath;
     }
     return null;
 }
-function resolveMatches(matches, remainder, aliasKey) {
-    const foundFile = matches[0];
-    const aliasRoot = foundFile.split(remainder)[0].replace(/\\/g, "/");
-    cache_1.CacheManager.set(constants_1.CACHE_KEYS.ALIASES, aliasKey, aliasRoot);
-    return foundFile;
+function resolveMatches(matches, remainder) {
+    const foundFile = matches[0].norm();
+    const dSplit = foundFile.split(remainder);
+    if (dSplit.length < 2)
+        return "";
+    return dSplit[0].replace(/\\/g, "/");
 }

package/dist/resolvers/php/php-resolver.js

@@ -15,6 +15,7 @@ const store_1 = require("../../store");
 const constants_1 = require("../../constants");
 const cache_1 = require("../../core/managers/cache");
 const collections_1 = require("../../shared/collections");
+const promises_1 = __importDefault(require("fs/promises")); // (add near the top if not present)
 /** Ensure we have a PHP resolver context for the current root */
 function buildPhpCtx(root, prev) {
     if (prev?.kind === "php")
@@ -53,7 +54,6 @@ async function resolvePhpImports({ filePath, visited = new Set(), depth = 0, max
         return (0, collections_1.emptyResult)(visited);
     // Context + exclusions
     const phpCtx = buildPhpCtx(ROOT, ctx);
-    const isExcluded = (0, shared_1.makeExcludeMatcher)(excludePatterns);
     // Parse imports (expand grouped `use` syntax)
     const raw = (0, extract_imports_1.extractPhpImports)(code);
     const imports = (0, extract_imports_1.expandGroupedUses)(raw);
@@ -70,11 +70,14 @@ async function resolvePhpImports({ filePath, visited = new Set(), depth = 0, max
         // Only resolve PSR-4 mapped namespaces
         if (!startsWithAnyNamespace(imp, phpCtx.nsKeys))
             continue;
-        if (isExcluded(imp))
+        if ((0, shared_1.isExcluded)(imp, excludePatterns))
             continue;
-        stats.expected.add(imp);
         // Resolve namespace → file path (sync helper retained)
         const resolvedPath = await tryResolvePhpFile(imp, filePath, phpCtx.psr4);
+        // Exclusion check after final resolution
+        if ((0, shared_1.isExcluded)(resolvedPath, excludePatterns))
+            continue;
+        stats.expected.add(imp);
         if (!resolvedPath)
             continue;
         stats.resolved.add(imp);
@@ -97,7 +100,6 @@ async function resolvePhpImports({ filePath, visited = new Set(), depth = 0, max
         logger_1.logger.debug("[php-resolver] unresolved:", [...unresolved]);
     return { files: out, visited, stats };
 }
-const promises_1 = __importDefault(require("fs/promises")); // (add near the top if not present)
 async function tryResolvePhpFile(imp, fromFile, psr4) {
     const key = `php:${imp}:${fromFile}`;
     const cached = cache_1.CacheManager.get(constants_1.CACHE_KEYS.PHP_FILECACHE, key);

package/dist/shared/patterns.js

@@ -11,9 +11,11 @@ const micromatch_1 = __importDefault(require("micromatch"));
  * Returns true if a given path matches any of the provided glob patterns.
  * Equivalent to core/helpers.isExcluded().
  */
-function isExcluded(p, patterns = [], root = process.cwd()) {
+function isExcluded(p = "", patterns = [], root = process.cwd()) {
     if (!patterns?.length)
         return false;
+    if (!p)
+        return false;
     const relPath = p.replaceAll("\\", "/");
     return micromatch_1.default.isMatch(relPath, patterns);
 }

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "prodex",
-  "version": "1.4.1",
+  "version": "1.4.5",
   "description": "Unified Project Indexer & Dependency Extractor for Laravel + React + Node stacks.",
   "type": "commonjs",
   "bin": {
     "prodex": "./bin/prodex.js"
   },
   "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "files": [
     "dist/",
     "bin/",
@@ -27,7 +26,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "prepare": "npm run build",
+    "gen:schema": "node schema/generate.js",
+    "prepare": "npm run build && npm run gen:schema",
     "d:w": "nodemon --watch dist --delay 500ms --exec node --inspect-brk dist/debug.js"
   },
   "engines": {
@@ -38,6 +38,7 @@
   "devDependencies": {
     "@types/node": "^24.9.2",
     "nodemon": "^3.1.10",
+    "ts-json-schema-generator": "^2.4.0",
     "typescript": "^5.9.3"
   },
   "dependencies": {
@@ -45,6 +46,7 @@
     "fast-glob": "^3.3.3",
     "inquirer": "^12.10.0",
     "micromatch": "^4.0.8",
-    "sade": "^1.8.1"
+    "sade": "^1.8.1",
+    "source-map-support": "^0.5.21"
   }
 }