prodex 1.0.0 → 1.0.2

package/README.md

@@ -39,7 +39,13 @@ npm install --save-dev prodex
 Run directly from your project root:
 
 ```bash
-prodex
+prodex 
+```
+
+OR
+
+```bash
+npx prodex 
 ```
 
 You’ll be guided through an interactive CLI:
@@ -159,21 +165,6 @@ prodex --depth 3 --output ./dump.txt --debug
 
 ---
 
-## 🧾 Publishing to npm
-
-```bash
-# Build and test locally
-npm run build
-
-# Version bump
-npm version patch   # or minor / major
-
-# Log in and publish
-npm login
-npm publish --access public
-```
-
----
 
 ## 💡 Philosophy
 
@@ -185,13 +176,6 @@ and designed to be both *safe* and *predictable.*
 
 ---
 
-## 🧑‍💻 Maintained by **emxhive**
-
-Prodex is part of the **Forge** developer ecosystem by **emxhive**,  
-a suite of modular tools for Laravel + React applications.
-
----
-
 ## 🧾 License
 
 MIT © 2025 emxhive

package/bin/prodex.js

@@ -1,2 +1,17 @@
 #!/usr/bin/env node
-import("../src/index.js").then(({ default: startProdex }) => startProdex());
+import fs from "fs";
+import path from "path";
+import { pathToFileURL, fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const devPath = path.resolve(__dirname, "../src/index.js");
+const distPath = path.resolve(__dirname, "../dist/index.js");
+
+const entry = fs.existsSync(distPath) ? distPath : devPath;
+
+// Convert to file:// URL for Windows compatibility
+const entryUrl = pathToFileURL(entry).href;
+
+import(entryUrl).then(({ default: startProdex }) => startProdex());

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zeki
+
+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/dist/README.md

@@ -0,0 +1,181 @@
+# 🧩 Prodex — Unified Project Indexer & Dependency Extractor
+
+**Prodex** *(short for “Project Index”)* is a smart cross-language dependency combiner for modern web stacks — built to traverse **Laravel + React + TypeScript** projects and extract a clean, flattened scope of every linked file.
+
+Whether you’re debugging imports, building AI context files, or simply auditing what your app actually depends on — Prodex builds you a unified **project index** in seconds.
+
+---
+
+## 🚀 Key Features
+
+| Feature | Description |
+|----------|-------------|
+| ⚙️ **Cross-language resolver** | Understands both JavaScript / TypeScript (`import`, `require`, `export * from`) and PHP (`use`, `require`, `include`) dependency trees. |
+| 🧩 **Laravel-aware bindings** | Reads your `app/Providers` and automatically maps interfaces to their concrete implementations. |
+| 🧭 **Smart alias detection** | Parses `tsconfig.json` and `vite.config.*` for alias paths (`@/components/...`). |
+| 🗂 **Grouped imports support** | Expands `use App\Http\Controllers\{A,B,C}` into individual files. |
+| 🔄 **Recursive chain following** | Walks through imports, re-exports, and PSR-4 namespaces up to your configured depth. |
+| 🪶 **Clean combined output** | Merges every resolved file into one `.txt` or `.md` file with region markers for readability. |
+| 🧠 **Static & safe** | No runtime PHP execution — everything is parsed statically via regex + PSR-4 mapping. |
+
+---
+
+## 📦 Installation
+
+```bash
+npm install -g prodex
+```
+
+or locally:
+
+```bash
+npm install --save-dev prodex
+```
+
+---
+
+## 🧰 Usage
+
+Run directly from your project root:
+
+```bash
+prodex 
+```
+
+OR
+
+```bash
+npx prodex 
+```
+
+You’ll be guided through an interactive CLI:
+
+```
+🧩 Prodex — Project Dependency Extractor
+🧩 Active Config:
+ • Output: ./combined.txt
+ • Scan Depth: 2
+ • Base Dirs: app, routes, resources/js
+```
+
+After selecting files and confirming, Prodex generates:
+
+```
+✅ combined.txt written (12 file(s)).
+```
+
+Each file appears wrapped in annotated regions:
+
+```
+// ==== path: app/Services/Shots/ComputeService.php ====
+// #region app/Services/Shots/ComputeService.php
+<?php
+// your code here...
+// #endregion
+```
+
+---
+
+## ⚙️ Configuration
+
+Create a `.prodex.json` in your project root (optional):
+
+```jsonc
+{
+  "output": "./combined.txt",
+  "scanDepth": 3,
+  "baseDirs": ["app", "routes", "resources/js"],
+  "entryExcludes": ["vendor", "node_modules"],
+  "importExcludes": ["vendor", "tests"]
+}
+```
+
+Prodex automatically merges this with sane defaults.
+
+---
+
+## 🧩 How It Works
+
+**1. Config Loader**
+- Reads `.prodex.json`, `tsconfig.json`, and `vite.config.*`.
+- Builds alias + exclusion map.
+
+**2. JS Resolver**
+- Extracts ES modules, dynamic imports, and re-exports.
+- Resolves alias paths to absolute file locations.
+
+**3. PHP Resolver**
+- Parses `use`, grouped `use {}`, `require`, and `include`.
+- Expands PSR-4 namespaces via `composer.json`.
+- Loads bindings from all `app/Providers/*.php` to link interfaces to implementations.
+
+**4. Combiner**
+- Follows all dependency chains (recursive up to limit).
+- Writes a single combined file with a TOC and inline region markers.
+
+---
+
+## 🧱 Example: Laravel + React Project
+
+```bash
+prodex
+```
+
+```
+🧩 Following dependency chain...
+✅ combined.txt written (24 file(s)).
+```
+
+Included files:
+
+```
+resources/js/pages/accounts.tsx
+app/Http/Controllers/Shots/AccountsController.php
+app/Repositories/Shots/FireflyApiRepository.php
+app/Enums/Shots/Granularity.php
+app/Support/Shots/CacheKeys.php
+...
+```
+
+---
+
+## 🧠 Ideal Use Cases
+
+- 🧩 Feeding combined source to **AI assistants / context engines**
+- 🧪 Static dependency audits or architecture mapping
+- 🧰 Quick “code snapshot” before refactors
+- 📄 Documentation generation / single-file review
+
+---
+
+## 🔧 CLI Flags (optional)
+
+| Flag | Description |
+|------|-------------|
+| `--depth <n>` | Override scan depth |
+| `--output <path>` | Custom output path |
+| `--no-chain` | Disable dependency recursion |
+| `--debug` | Enable verbose logging |
+
+Example:
+
+```bash
+prodex --depth 3 --output ./dump.txt --debug
+```
+
+---
+
+
+## 💡 Philosophy
+
+Prodex isn’t a linter or bundler —  
+it’s an **indexer** that unifies multi-language project contexts for smarter automation, analysis, and AI-assisted workflows.
+
+Built with care for mixed stacks like **Laravel + Inertia + React**,  
+and designed to be both *safe* and *predictable.*
+
+---
+
+## 🧾 License
+
+MIT © 2025 emxhive

package/dist/bin/prodex.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import fs from "fs";
+import path from "path";
+import { pathToFileURL, fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const devPath = path.resolve(__dirname, "../src/index.js");
+const distPath = path.resolve(__dirname, "../dist/index.js");
+
+const entry = fs.existsSync(distPath) ? distPath : devPath;
+
+// Convert to file:// URL for Windows compatibility
+const entryUrl = pathToFileURL(entry).href;
+
+import(entryUrl).then(({ default: startProdex }) => startProdex());

package/dist/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "prodex",
+  "version": "1.0.2",
+  "description": "Unified Project Indexer & Dependency Extractor for Laravel + React + Node stacks.",
+  "type": "module",
+  "bin": {
+    "prodex": "./bin/prodex.js"
+  },
+  "main": "./dist/core/combine.js",
+  "exports": {
+    ".": "./dist/core/combine.js"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "laravel",
+    "react",
+    "typescript",
+    "dependency",
+    "analyzer",
+    "cli",
+    "node",
+    "indexer"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && mkdir -p dist && cp -r src bin package.json README.md LICENSE dist/",
+    "prepare": "npm run build"
+  },
+  "author": "emxhive",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "inquirer": "^12.10.0"
+  }
+}

package/dist/src/cli/picker.js

@@ -0,0 +1,51 @@
+import fs from "fs";
+import path from "path";
+import inquirer from "inquirer";
+import { ROOT } from "../constants/config.js";
+import { walk, rel } from "../core/helpers.js";
+
+export async function pickEntries(baseDirs, depth = 2) {
+  let selected = [];
+  while (true) {
+    const files = [];
+    for (const base of baseDirs) {
+      const full = path.join(ROOT, base);
+      if (!fs.existsSync(full)) continue;
+      for (const f of walk(full, 0, depth)) files.push(f);
+    }
+
+    const choices = files.map(f => ({ name: rel(f), value: f }));
+    choices.push(new inquirer.Separator());
+    choices.push({ name: "🔽 Load more (go deeper)", value: "__loadmore" });
+    choices.push({ name: "📝 Enter custom path", value: "__manual" });
+
+    const { picks } = await inquirer.prompt([
+      {
+        type: "checkbox",
+        name: "picks",
+        message: `Select entry files (depth ${depth})`,
+        choices,
+        loop: false,
+        pageSize: 20,
+        default: selected
+      }
+    ]);
+
+    if (picks.includes("__manual")) {
+      const { manual } = await inquirer.prompt([
+        { name: "manual", message: "Enter relative path:" }
+      ]);
+      if (manual.trim()) selected.push(path.resolve(ROOT, manual.trim()));
+    }
+
+    if (picks.includes("__loadmore")) {
+      depth++;
+      selected = picks.filter(p => !["__manual", "__loadmore"].includes(p));
+      continue;
+    }
+
+    selected = picks.filter(p => !["__manual", "__loadmore"].includes(p));
+    break;
+  }
+  return [...new Set(selected)];
+}

package/dist/src/cli/summary.js

@@ -0,0 +1,9 @@
+export function showSummary({ outputDir, fileName, entries, scanDepth, limit, chain }) {
+  console.log("\n🧩 Active Run:");
+  console.log(" • Output Directory:", outputDir);
+  console.log(" • File Name:", fileName);
+  console.log(" • Entries:", entries.length);
+  console.log(" • Scan Depth:", scanDepth);
+  console.log(" • Limit:", limit);
+  console.log(" • Chain:", chain ? "Enabled" : "Disabled");
+}

package/{src → dist/src}/constants/config-loader.js

@@ -9,6 +9,11 @@ import {
   BASE_DIRS
 } from "./config.js";
 
+/**
+ * Loads and merges the Prodex configuration.
+ *  - `output` is treated strictly as a directory.
+ *  - Defaults to ROOT/prodex when not defined.
+ */
 export function loadProdexConfig() {
   const configPath = path.join(ROOT, ".prodex.json");
   let userConfig = {};
@@ -17,24 +22,37 @@ export function loadProdexConfig() {
     try {
       const data = fs.readFileSync(configPath, "utf8");
       userConfig = JSON.parse(data);
-      console.log("🧠 Loaded .prodex.json overrides");
+      console.log("? Loaded .prodex.json overrides");
     } catch (err) {
-      console.warn("⚠️  Failed to parse .prodex.json:", err.message);
+      console.warn("??  Failed to parse .prodex.json:", err.message);
     }
   }
 
+  // Resolve output directory (always a folder now)
+  const outputDir = userConfig.output
+    ? path.resolve(ROOT, userConfig.output)
+    : path.join(ROOT, "prodex");
+
+  // Ensure directory exists
+  try {
+    fs.mkdirSync(outputDir, { recursive: true });
+  } catch (e) {
+    console.warn("??  Could not create output directory:", outputDir);
+  }
+
   const merged = {
-    output: userConfig.output || OUT_FILE,
+    output: outputDir,
     scanDepth: userConfig.scanDepth || 2,
     codeExts: userConfig.codeExts || CODE_EXTS,
     entryExcludes: [...ENTRY_EXCLUDES, ...(userConfig.entryExcludes || [])],
     importExcludes: [...IMPORT_EXCLUDES, ...(userConfig.importExcludes || [])],
     baseDirs: [...new Set([...(userConfig.baseDirs || []), ...BASE_DIRS])],
-    aliasOverrides: userConfig.aliasOverrides || {}
+    aliasOverrides: userConfig.aliasOverrides || {},
+    limit: userConfig.limit || 200
   };
 
-  console.log("🧩 Active Config:");
-  console.log(" • Output:", merged.output);
+  console.log("?? Active Config:");
+  console.log(" • Output Directory:", merged.output);
   console.log(" • Scan Depth:", merged.scanDepth);
   console.log(" • Base Dirs:", merged.baseDirs.join(", "));
   if (userConfig.entryExcludes || userConfig.importExcludes)

package/dist/src/constants/config.js

@@ -0,0 +1,84 @@
+import { resolveJsImports } from "../resolvers/js-resolver.js";
+import { resolvePhpImports } from "../resolvers/php-resolver.js";
+
+
+export const ROOT = process.cwd();
+export const OUT_FILE = ROOT + "/combined.txt";
+export const CODE_EXTS = [".js", ".mjs", ".ts", ".tsx", ".d.ts", ".php"];
+export const ENTRY_EXCLUDES = [
+  "resources/js/components/ui/",
+  "app/Enums/",
+  "app/DTOs/",
+  "app/Models/",
+  "app/Data/",
+  "resources/js/wayfinder/",
+  "resources/js/routes/",
+  "resources/js/actions/",
+  "resources/js/hooks/"
+];
+export const IMPORT_EXCLUDES = [
+  "node_modules",
+  "@shadcn/",
+  "@/components/ui/",
+  "@components/ui/",
+  "resources/js/components/ui/",
+  "resources/js/hooks/",
+  "resources/js/wayfinder/",
+  "resources/js/routes/",
+  "resources/js/actions/"
+];
+export const BASE_DIRS = ["src", "bin", "schema", "app", "routes", "resources/js"];
+
+
+/**
+ * Resolver map — links file extensions to their resolver functions.
+ * Extend this to support new formats (.vue, .jsx, etc.).
+ */
+export const RESOLVERS = {
+  ".php": resolvePhpImports,
+  ".ts": resolveJsImports,
+  ".tsx": resolveJsImports,
+  ".d.ts": resolveJsImports,
+  ".js": resolveJsImports
+};
+
+/**
+ * Prompt definitions used by Inquirer in combine.js.
+ * These are constants to keep UI consistent across releases.
+ */
+export const PROMPTS = {
+  yesToAll: {
+    type: "confirm",
+    name: "yesToAll",
+    message: "Proceed automatically with default settings (Yes to all)?",
+    default: true
+  },
+  combine: [
+    {
+      type: "input",
+      name: "outputBase",
+      message: "Output base name (without extension):",
+      default: null, // will be set dynamically
+      filter: v => v.trim()
+    },
+    {
+      type: "number",
+      name: "limit",
+      message: "Limit number of merged files:",
+      default: 200, // will be overridden at runtime
+      validate: v => (!isNaN(v) && v > 0) || "Enter a valid positive number"
+    },
+    {
+      type: "confirm",
+      name: "chain",
+      message: "Follow dependency chain?",
+      default: true
+    },
+    {
+      type: "confirm",
+      name: "proceed",
+      message: "Proceed with combine?",
+      default: true
+    }
+  ]
+};

package/dist/src/core/combine.js

@@ -0,0 +1,145 @@
+import fs from "fs";
+import path from "path";
+import inquirer from "inquirer";
+import {
+  ROOT,
+  CODE_EXTS,
+  RESOLVERS,
+  PROMPTS
+} from "../constants/config.js";
+import { loadProdexConfig } from "../constants/config-loader.js";
+import { read, normalizeIndent, stripComments, rel } from "./helpers.js";
+import { pickEntries } from "../cli/picker.js";
+import { showSummary } from "../cli/summary.js";
+import { generateOutputName, resolveOutputPath } from "./file-utils.js";
+
+export async function runCombine() {
+  const cliLimitFlag = process.argv.find(arg => arg.startsWith("--limit="));
+  const customLimit = cliLimitFlag ? parseInt(cliLimitFlag.split("=")[1], 10) : null;
+
+  const cfg = loadProdexConfig();
+  const { baseDirs, scanDepth } = cfg;
+
+  const entries = await pickEntries(baseDirs, scanDepth);
+  if (!entries.length) {
+    console.log("❌ No entries selected.");
+    return;
+  }
+
+  const autoName = generateOutputName(entries);
+  const outputDir = cfg.output || path.join(ROOT, "prodex");
+  const defaultLimit = customLimit || cfg.limit || 200;
+
+  console.log("\n📋 You selected:");
+  for (const e of entries) console.log(" -", rel(e));
+
+  const { yesToAll } = await inquirer.prompt([PROMPTS.yesToAll]);
+
+  let outputBase = autoName,
+    limit = defaultLimit,
+    chain = true,
+    proceed = true;
+
+  if (!yesToAll) {
+    // clone static prompts with dynamic defaults
+    const combinePrompts = PROMPTS.combine.map(p => ({
+      ...p,
+      default:
+        p.name === "outputBase"
+          ? autoName
+          : p.name === "limit"
+            ? defaultLimit
+            : p.default
+    }));
+
+    const ans = await inquirer.prompt(combinePrompts);
+    outputBase = ans.outputBase || autoName;
+    limit = ans.limit;
+    chain = ans.chain;
+    proceed = ans.proceed;
+  }
+
+  if (!proceed) {
+    console.log("⚙️  Aborted.");
+    return;
+  }
+
+  // ensure output directory exists
+  try {
+    fs.mkdirSync(outputDir, { recursive: true });
+  } catch {
+    console.warn("⚠️  Could not create output directory:", outputDir);
+  }
+
+  const output = resolveOutputPath(outputDir, outputBase);
+
+  showSummary({
+    outputDir,
+    fileName: path.basename(output),
+    entries,
+    scanDepth: cfg.scanDepth,
+    limit,
+    chain
+  });
+
+  const finalFiles = chain ? await followChain(entries, limit) : entries;
+
+  fs.writeFileSync(
+    output,
+    [toc(finalFiles), ...finalFiles.map(render)].join(""),
+    "utf8"
+  );
+
+  console.log(`\n✅ ${output} written (${finalFiles.length} file(s)).`);
+}
+
+function header(p) {
+  return `##==== path: ${rel(p)} ====`;
+}
+function regionStart(p) {
+  return `##region ${rel(p)}`;
+}
+const regionEnd = "##endregion";
+
+function render(p) {
+  const ext = path.extname(p);
+  let s = read(p);
+  s = stripComments(s, ext);
+  s = normalizeIndent(s);
+  return `${header(p)}\n${regionStart(p)}\n${s}\n${regionEnd}\n\n`;
+}
+
+function toc(files) {
+  return (
+    ["// ==== Combined Scope ====", ...files.map(f => "// - " + rel(f))].join(
+      "\n"
+    ) + "\n\n"
+  );
+}
+
+async function followChain(entryFiles, limit = 200) {
+  console.log("🧩 Following dependency chain...");
+  const visited = new Set();
+  const all = [];
+
+  for (const f of entryFiles) {
+    if (visited.has(f)) continue;
+    all.push(f);
+
+    const ext = path.extname(f);
+    if (!CODE_EXTS.includes(ext)) continue;
+
+    const resolver = RESOLVERS[ext];
+    if (resolver) {
+      const { files } = await resolver(f, visited);
+      all.push(...files);
+    }
+
+    if (all.length >= limit) {
+      console.log("⚠️  Limit reached:", limit);
+      break;
+    }
+  }
+
+  return [...new Set(all)];
+}

package/dist/src/core/file-utils.js

@@ -0,0 +1,13 @@
+import path from "path";
+
+export function generateOutputName(entries) {
+  const names = entries.map(f => path.basename(f, path.extname(f)));
+  if (names.length === 1) return names[0];
+  if (names.length === 2) return `${names[0]}-${names[1]}`;
+  if (names.length > 2) return `${names[0]}-and-${names.length - 1}more`;
+  return "unknown";
+}
+
+export function resolveOutputPath(outputDir, base) {
+  return path.join(outputDir, `prodex-${base}-combined.txt`);
+}

package/dist/src/core/helpers.js

@@ -0,0 +1,116 @@
+import fs from "fs";
+import path from "path";
+import { ROOT, CODE_EXTS, ENTRY_EXCLUDES } from "../constants/config.js";
+
+export function rel(p) {
+  return path.relative(ROOT, p).replaceAll("\\", "/");
+}
+
+export function read(p) {
+  try {
+    return fs.readFileSync(p, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+export function normalizeIndent(s) {
+  return s
+    .replace(/\t/g, "  ")
+    .split("\n")
+    .map(l => l.replace(/[ \t]+$/, ""))
+    .join("\n");
+}
+
+export function stripComments(code, ext) {
+  // Fast path for PHP or non-JS files — simple regex is fine
+  if (ext === ".php") {
+    return code
+      .replace(/\/\*[\s\S]*?\*\//g, "") // block comments
+      .replace(/^\s*#.*$/gm, ""); // line comments
+  }
+
+  // Robust JS/TS-safe parser — avoids stripping inside strings
+  let out = "";
+  let inStr = false;
+  let strChar = "";
+  let inBlockComment = false;
+  let inLineComment = false;
+
+  for (let i = 0; i < code.length; i++) {
+    const c = code[i];
+    const next = code[i + 1];
+
+    if (inBlockComment) {
+      if (c === "*" && next === "/") {
+        inBlockComment = false;
+        i++;
+      }
+      continue;
+    }
+
+    if (inLineComment) {
+      if (c === "\n") {
+        inLineComment = false;
+        out += c;
+      }
+      continue;
+    }
+
+    if (inStr) {
+      if (c === "\\" && next) {
+        out += c + next;
+        i++;
+        continue;
+      }
+      if (c === strChar) inStr = false;
+      out += c;
+      continue;
+    }
+
+    if (c === '"' || c === "'" || c === "`") {
+      inStr = true;
+      strChar = c;
+      out += c;
+      continue;
+    }
+
+    if (c === "/" && next === "*") {
+      inBlockComment = true;
+      i++;
+      continue;
+    }
+
+    if (c === "/" && next === "/") {
+      inLineComment = true;
+      i++;
+      continue;
+    }
+
+    out += c;
+  }
+
+  return out;
+}
+
+
+export function isEntryExcluded(p) {
+  const r = rel(p);
+  return ENTRY_EXCLUDES.some(ex => r.startsWith(ex) || r.includes(ex));
+}
+
+export function* walk(dir, depth = 0, maxDepth = 2) {
+  if (depth > maxDepth) return;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const e of entries) {
+    const full = path.join(dir, e.name);
+    if (e.isDirectory()) yield* walk(full, depth + 1, maxDepth);
+    else if (e.isFile()) {
+      const ext = path.extname(e.name).toLowerCase();
+      const relPath = rel(full);
+      if (CODE_EXTS.includes(ext) && !ENTRY_EXCLUDES.some(ex => relPath.startsWith(ex))) {
+        yield full;
+      }
+    }
+  }
+}

package/{src → dist/src}/resolvers/php-bindings.js

@@ -15,7 +15,7 @@ export function loadLaravelBindings() {
 
     // Match: $this->app->bind(Interface::class, Implementation::class)
     const re =
-        /\$this->app->(?:bind|singleton)\s*\(\s*([A-Za-z0-9_:\\\\]+)::class\s*,\s*([A-Za-z0-9_:\\\\]+)::class/g;
+        /$this->app->(?:bind|singleton)\s*\(\s*([A-Za-z0-9_:\\\\]+)::class\s*,\s*([A-Za-z0-9_:\\\\]+)::class/g;
 
     for (const file of files) {
         const code = fs.readFileSync(file, "utf8");

package/{src → dist/src}/resolvers/php-resolver.js

@@ -69,7 +69,7 @@ export async function resolvePhpImports(
         .split(",")
         .map(x => x.trim())
         .filter(Boolean);
-      for (const p of parts) matches.add(`${base}\\${p}`);
+      for (const p of parts) matches.add(`${base}\${p}`);
     } else {
       matches.add(imp.trim());
     }

package/package.json

@@ -1,18 +1,43 @@
 {
   "name": "prodex",
-  "version": "1.0.0",
-  "description": "Unified Project Indexer & Dependency Extractor for Laravel + React stacks.",
+  "version": "1.0.2",
+  "description": "Unified Project Indexer & Dependency Extractor for Laravel + React + Node stacks.",
   "type": "module",
   "bin": {
     "prodex": "./bin/prodex.js"
   },
+  "main": "./dist/core/combine.js",
+  "exports": {
+    ".": "./dist/core/combine.js"
+  },
   "files": [
+    "dist/",
     "bin/",
-    "src/",
     "README.md",
     "LICENSE"
   ],
-  "keywords": ["laravel", "react", "typescript", "dependency", "analyzer", "cli"],
+  "keywords": [
+    "laravel",
+    "react",
+    "typescript",
+    "dependency",
+    "analyzer",
+    "cli",
+    "node",
+    "indexer"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && mkdir -p dist && cp -r src bin package.json README.md LICENSE dist/",
+    "prepare": "npm run build"
+  },
   "author": "emxhive",
-  "license": "MIT"
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "inquirer": "^12.10.0"
+  }
 }

package/src/cli/picker.js

@@ -1,8 +0,0 @@
-import inquirer from "inquirer";
-
-export async function pickEntries() {
-  const { path } = await inquirer.prompt([
-    { name: "path", message: "Enter path to combine:", default: "src" }
-  ]);
-  return [path];
-}

package/src/cli/summary.js

@@ -1,4 +0,0 @@
-export function printSummary(entries) {
-  console.log("\nYou selected:");
-  for (const e of entries) console.log(" -", e);
-}

package/src/constants/config.js

@@ -1,26 +0,0 @@
-export const ROOT = process.cwd();
-export const OUT_FILE = ROOT + "/combined.txt";
-export const CODE_EXTS = [".ts", ".tsx", ".d.ts", ".php"];
-export const ENTRY_EXCLUDES = [
-  "resources/js/components/ui/",
-  "app/Enums/",
-  "app/DTOs/",
-  "app/Models/",
-  "app/Data/",
-  "resources/js/wayfinder/",
-  "resources/js/routes/",
-  "resources/js/actions/",
-  "resources/js/hooks/"
-];
-export const IMPORT_EXCLUDES = [
-  "node_modules",
-  "@shadcn/",
-  "@/components/ui/",
-  "@components/ui/",
-  "resources/js/components/ui/",
-  "resources/js/hooks/",
-  "resources/js/wayfinder/",
-  "resources/js/routes/",
-  "resources/js/actions/"
-];
-export const BASE_DIRS = ["app", "routes", "resources/js"];

package/src/core/combine.js

@@ -1,129 +0,0 @@
-import fs from "fs";
-import path from "path";
-import inquirer from "inquirer";
-import { ROOT } from "../constants/config.js";
-import { loadProdexConfig } from "../constants/config-loader.js";
-import { read, normalizeIndent, stripComments, walk, rel } from "./helpers.js";
-import { resolveJsImports } from "../resolvers/js-resolver.js";
-import { resolvePhpImports } from "../resolvers/php-resolver.js";
-
-export async function runCombine() {
-  const cfg = loadProdexConfig();
-  const { output, baseDirs, scanDepth } = cfg;
-
-  const entries = await pickEntries(baseDirs, scanDepth);
-  if (!entries.length) {
-    console.log("❌ No entries selected.");
-    return;
-  }
-
-  const { chain, limit, proceed } = await pickSettings(entries);
-  if (!proceed) {
-    console.log("⚙️  Aborted.");
-    return;
-  }
-
-  const finalFiles = chain ? await followChain(entries, limit) : entries;
-  fs.writeFileSync(output, [toc(finalFiles), ...finalFiles.map(render)].join(""), "utf8");
-  console.log(`\n✅ ${output} written (${finalFiles.length} file(s)).`);
-}
-
-// ---------- UI ----------
-async function pickEntries(baseDirs, depth = 2) {
-  let selected = [];
-  while (true) {
-    const files = [];
-    for (const base of baseDirs) {
-      const full = path.join(ROOT, base);
-      if (!fs.existsSync(full)) continue;
-      for (const f of walk(full, 0, depth)) files.push(f);
-    }
-
-    const choices = files.map(f => ({ name: rel(f), value: f }));
-    choices.push(new inquirer.Separator());
-    choices.push({ name: "🔽 Load more (go deeper)", value: "__loadmore" });
-    choices.push({ name: "📝 Enter custom path", value: "__manual" });
-
-    const { picks } = await inquirer.prompt([
-      {
-        type: "checkbox",
-        name: "picks",
-        message: `Select entry files (depth ${depth})`,
-        choices,
-        loop: false,
-        pageSize: 20,
-        default: selected
-      }
-    ]);
-
-    if (picks.includes("__manual")) {
-      const { manual } = await inquirer.prompt([{ name: "manual", message: "Enter relative path:" }]);
-      if (manual.trim()) selected.push(path.resolve(ROOT, manual.trim()));
-    }
-
-    if (picks.includes("__loadmore")) {
-      depth++;
-      selected = picks.filter(p => !["__manual", "__loadmore"].includes(p));
-      continue;
-    }
-
-    selected = picks.filter(p => !["__manual", "__loadmore"].includes(p));
-    break;
-  }
-  return [...new Set(selected)];
-}
-
-async function pickSettings(entries) {
-  console.log("\n📋 You selected:");
-  for (const e of entries) console.log(" -", rel(e));
-  const ans = await inquirer.prompt([
-    { type: "confirm", name: "chain", message: "Follow dependency chain?", default: true },
-    { type: "number", name: "limit", message: "Limit number of merged files:", default: 200, validate: v => (!isNaN(v) && v > 0) || "Enter valid number" },
-    { type: "confirm", name: "proceed", message: "Proceed with combine?", default: true }
-  ]);
-  return ans;
-}
-
-// ---------- Combine logic ----------
-function header(p) { return `// ==== path: ${rel(p)} ====`; }
-function regionStart(p) { return `// #region ${rel(p)}`; }
-const regionEnd = "// #endregion";
-
-function render(p) {
-  const ext = path.extname(p);
-  let s = read(p);
-  s = stripComments(s, ext);
-  s = normalizeIndent(s);
-  return `${header(p)}\n${regionStart(p)}\n${s}\n${regionEnd}\n\n`;
-}
-
-function toc(files) {
-  return ["// ==== Combined Scope ====", ...files.map(f => "// - " + rel(f))].join("\n") + "\n\n";
-}
-
-async function followChain(entryFiles, limit = 200) {
-  console.log("🧩 Following dependency chain...");
-  const visited = new Set();
-  const all = [];
-
-  for (const f of entryFiles) {
-    if (visited.has(f)) continue;
-    all.push(f);
-    const ext = path.extname(f);
-
-    if ([".ts", ".tsx", ".d.ts"].includes(ext)) {
-      const { files } = await resolveJsImports(f, visited);
-      all.push(...files);
-    } else if (ext === ".php") {
-      const { files } = await resolvePhpImports(f, visited);
-      all.push(...files);
-    }
-
-    if (all.length >= limit) {
-      console.log("⚠️  Limit reached:", limit);
-      break;
-    }
-  }
-
-  return [...new Set(all)];
-}

package/src/core/exclusions.js

@@ -1,23 +0,0 @@
-export const ENTRY_EXCLUDES = [
-  "resources/js/components/ui/",
-  "app/Enums/",
-  "app/DTOs/",
-  "app/Models/",
-  "app/Data/",
-  "resources/js/wayfinder/",
-  "resources/js/routes/",
-  "resources/js/actions/",
-  "resources/js/hooks/",
-];
-
-export const IMPORT_EXCLUDES = [
-  "node_modules",
-  "@shadcn/",
-  "@/components/ui/",
-  "@components/ui/",
-  "resources/js/components/ui/",
-  "resources/js/hooks/",
-  "resources/js/wayfinder/",
-  "resources/js/routes/",
-  "resources/js/actions/",
-];

package/src/core/file-utils.js

@@ -1,19 +0,0 @@
-import inquirer from "inquirer";
-import fs from "fs";
-import path from "path";
-
-export async function runCombine() {
-  console.log("📦 Combine mode active. (Stub)");
-  console.log("This is where the full combine logic from your previous script will go.\n");
-
-  const { confirm } = await inquirer.prompt([
-    { type: "confirm", name: "confirm", message: "Would you like to list project files?", default: true }
-  ]);
-
-  if (confirm) {
-    const files = fs.readdirSync(process.cwd());
-    console.log("Found files:", files);
-  } else {
-    console.log("Aborted.");
-  }
-}

package/src/core/helpers.js

@@ -1,51 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { ROOT, CODE_EXTS, ENTRY_EXCLUDES } from "../constants/config.js";
-
-export function rel(p) {
-  return path.relative(ROOT, p).replaceAll("\\", "/");
-}
-
-export function read(p) {
-  try {
-    return fs.readFileSync(p, "utf8");
-  } catch {
-    return "";
-  }
-}
-
-export function normalizeIndent(s) {
-  return s
-    .replace(/\t/g, "  ")
-    .split("\n")
-    .map(l => l.replace(/[ \t]+$/, ""))
-    .join("\n");
-}
-
-export function stripComments(code, ext) {
-  let s = code.replace(/\/\*[\s\S]*?\*\//g, "");
-  s = s.replace(/(^|[^:])\/\/.*$/gm, (_m, p1) => p1);
-  if (ext === ".php") s = s.replace(/^\s*#.*$/gm, "");
-  return s;
-}
-
-export function isEntryExcluded(p) {
-  const r = rel(p);
-  return ENTRY_EXCLUDES.some(ex => r.startsWith(ex) || r.includes(ex));
-}
-
-export function* walk(dir, depth = 0, maxDepth = 2) {
-  if (depth > maxDepth) return;
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const e of entries) {
-    const full = path.join(dir, e.name);
-    if (e.isDirectory()) yield* walk(full, depth + 1, maxDepth);
-    else if (e.isFile()) {
-      const ext = path.extname(e.name).toLowerCase();
-      const relPath = rel(full);
-      if (CODE_EXTS.includes(ext) && !ENTRY_EXCLUDES.some(ex => relPath.startsWith(ex))) {
-        yield full;
-      }
-    }
-  }
-}