prodex 1.0.0

package/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/README.md

@@ -0,0 +1,197 @@
+# 🧩 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
+```
+
+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
+```
+
+---
+
+## 🧾 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
+
+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.*
+
+---
+
+## 🧑‍💻 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

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import("../src/index.js").then(({ default: startProdex }) => startProdex());

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "prodex",
+  "version": "1.0.0",
+  "description": "Unified Project Indexer & Dependency Extractor for Laravel + React stacks.",
+  "type": "module",
+  "bin": {
+    "prodex": "./bin/prodex.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": ["laravel", "react", "typescript", "dependency", "analyzer", "cli"],
+  "author": "emxhive",
+  "license": "MIT"
+}

package/src/cli/init.js

@@ -0,0 +1,49 @@
+import fs from "fs";
+import path from "path";
+import inquirer from "inquirer";
+
+export async function initProdex() {
+  console.log("🪄 Prodex Init — Configuration Wizard\n");
+
+  const dest = path.join(process.cwd(), ".prodex.json");
+  if (fs.existsSync(dest)) {
+    const { overwrite } = await inquirer.prompt([
+      { type: "confirm", name: "overwrite", message: ".prodex.json already exists. Overwrite?", default: false }
+    ]);
+    if (!overwrite) {
+      console.log("❌ Cancelled.");
+      return;
+    }
+  }
+
+  const jsonc = `{
+  // -------------------------------------------------------------
+  // 🧩 Prodex Configuration
+  // -------------------------------------------------------------
+  // Customize how Prodex flattens your project.
+  // For docs, visit: https://github.com/emxhive/prodex#configuration
+  // -------------------------------------------------------------
+
+  "$schema": "https://raw.githubusercontent.com/emxhive/prodex/main/schema/prodex.schema.json",
+
+  "output": "combined.txt",
+  "scanDepth": 2,
+  "baseDirs": ["app", "routes", "resources/js"],
+  "aliasOverrides": {
+    "@hooks": "resources/js/hooks",
+    "@data": "resources/js/data"
+  },
+  "entryExcludes": [
+    "resources/js/components/ui/",
+    "app/DTOs/"
+  ],
+  "importExcludes": [
+    "node_modules",
+    "@shadcn/"
+  ]
+}`;
+
+  fs.writeFileSync(dest, jsonc, "utf8");
+  console.log(`✅ Created ${dest}`);
+  console.log("💡 You can edit it anytime or rerun 'prodex init' to reset.");
+}

package/src/cli/picker.js

@@ -0,0 +1,8 @@
+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

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

package/src/constants/config-loader.js

@@ -0,0 +1,47 @@
+import fs from "fs";
+import path from "path";
+import {
+  ROOT,
+  OUT_FILE,
+  CODE_EXTS,
+  ENTRY_EXCLUDES,
+  IMPORT_EXCLUDES,
+  BASE_DIRS
+} from "./config.js";
+
+export function loadProdexConfig() {
+  const configPath = path.join(ROOT, ".prodex.json");
+  let userConfig = {};
+
+  if (fs.existsSync(configPath)) {
+    try {
+      const data = fs.readFileSync(configPath, "utf8");
+      userConfig = JSON.parse(data);
+      console.log("🧠 Loaded .prodex.json overrides");
+    } catch (err) {
+      console.warn("⚠️  Failed to parse .prodex.json:", err.message);
+    }
+  }
+
+  const merged = {
+    output: userConfig.output || OUT_FILE,
+    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 || {}
+  };
+
+  console.log("🧩 Active Config:");
+  console.log(" • Output:", merged.output);
+  console.log(" • Scan Depth:", merged.scanDepth);
+  console.log(" • Base Dirs:", merged.baseDirs.join(", "));
+  if (userConfig.entryExcludes || userConfig.importExcludes)
+    console.log(" • Custom Exclusions:", {
+      entries: userConfig.entryExcludes?.length || 0,
+      imports: userConfig.importExcludes?.length || 0
+    });
+
+  return merged;
+}

package/src/constants/config.js

@@ -0,0 +1,26 @@
+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/alias-loader.js

@@ -0,0 +1,8 @@
+export function loadJsAliases() {
+  // will later handle vite + tsconfig
+  return {};
+}
+export function loadComposerAliases() {
+  // will later handle composer.json PSR-4
+  return {};
+}

package/src/core/combine.js

@@ -0,0 +1,129 @@
+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

@@ -0,0 +1,23 @@
+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

@@ -0,0 +1,19 @@
+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

@@ -0,0 +1,51 @@
+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;
+      }
+    }
+  }
+}

package/src/index.js

@@ -0,0 +1,11 @@
+import { runCombine } from "./core/combine.js";
+import { initProdex } from "./cli/init.js";
+
+export default async function startProdex() {
+  const args = process.argv.slice(2);
+  if (args.includes("init")) return await initProdex();
+
+  console.clear();
+  console.log("🧩 Prodex — Project Dependency Extractor\n");
+  await runCombine();
+}

package/src/resolvers/js-resolver.js

@@ -0,0 +1,135 @@
+import fs from "fs";
+import path from "path";
+import { IMPORT_EXCLUDES, ROOT } from "../constants/config.js";
+
+const debug = process.env.PRODEX_DEBUG === "1";
+const log = (...args) => { if (debug) console.log("🪶 [resolver]", ...args); };
+
+// --- Loaders --------------------------------------------------
+
+function loadViteAliases() {
+  const files = [
+    "vite.config.ts",
+    "vite.config.js",
+    "vite.config.mts",
+    "vite.config.mjs",
+    "vite.config.cjs",
+  ];
+  const map = {};
+  for (const f of files) {
+    const p = path.join(ROOT, f);
+    if (!fs.existsSync(p)) continue;
+    const s = fs.readFileSync(p, "utf8");
+    const obj = /resolve\s*:\s*{[\s\S]*?alias\s*:\s*{([\s\S]*?)}/m.exec(s);
+    if (!obj) continue;
+    const re = /['"]([^'"]+)['"]\s*:\s*['"]([^'"]+)['"]/g;
+    let m;
+    while ((m = re.exec(obj[1]))) {
+      const key = m[1];
+      const raw = m[2].replace(/^\/+/, "");
+      const abs = path.resolve(ROOT, raw);
+      map[key] = abs;
+    }
+  }
+  return map;
+}
+
+function loadTsconfigAliases() {
+  const p = path.join(ROOT, "tsconfig.json");
+  if (!fs.existsSync(p)) return {};
+  let content = fs.readFileSync(p, "utf8")
+    .replace(/("(?:\\.|[^"\\])*")|\/\/.*$|\/\*[\s\S]*?\*\//gm, (_, q) => q || "")
+    .replace(/,\s*([}\]])/g, "$1");
+  let j;
+  try {
+    j = JSON.parse(content);
+  } catch {
+    return {};
+  }
+  const paths = j.compilerOptions?.paths || {};
+  const base = j.compilerOptions?.baseUrl || ".";
+  const map = {};
+  for (const k in paths) {
+    const arr = paths[k];
+    if (!Array.isArray(arr) || !arr.length) continue;
+    const from = k.replace(/\*$/, "");
+    const to = arr[0].replace(/\*$/, "");
+    map[from] = path.resolve(ROOT, base, to);
+  }
+  return map;
+}
+
+function loadJsAliases() {
+  return { ...loadTsconfigAliases(), ...loadViteAliases() };
+}
+
+// --- Resolver Core --------------------------------------------
+
+function tryResolveImport(basePath) {
+  const ext = path.extname(basePath);
+  const tries = [];
+  if (ext) tries.push(basePath);
+  else {
+    for (const x of [".ts", ".tsx", ".d.ts", ".js", ".jsx", ".mjs"])
+      tries.push(basePath + x, path.join(basePath, "index" + x));
+  }
+  for (const t of tries)
+    if (fs.existsSync(t) && fs.statSync(t).isFile()) return path.resolve(t);
+  return null;
+}
+
+function isImportExcluded(p) {
+  return IMPORT_EXCLUDES.some(ex => p.includes(ex));
+}
+
+export async function resolveJsImports(filePath, visited = new Set(), depth = 0, maxDepth = 10) {
+  if (visited.has(filePath)) return { files: [], visited };
+  visited.add(filePath);
+  if (isImportExcluded(filePath) || !fs.existsSync(filePath))
+    return { files: [], visited };
+
+  const code = fs.readFileSync(filePath, "utf8");
+  const ext = path.extname(filePath).toLowerCase();
+  if (![".ts", ".tsx", ".d.ts", ".js", ".jsx", ".mjs"].includes(ext))
+    return { files: [], visited };
+
+  const aliases = loadJsAliases();
+  const patterns = [
+    /import\s+[^'"]*['"]([^'"]+)['"]/g,
+    /import\(\s*['"]([^'"]+)['"]\s*\)/g,
+    /require\(\s*['"]([^'"]+)['"]\s*\)/g,
+    /export\s+\*\s+from\s+['"]([^'"]+)['"]/g,
+  ];
+
+  const matches = new Set();
+  for (const r of patterns) {
+    let m;
+    while ((m = r.exec(code))) matches.add(m[1]);
+  }
+
+  const resolved = [];
+  for (const imp of matches) {
+    if (!imp.startsWith(".") && !imp.startsWith("/") && !imp.startsWith("@")) continue;
+    if (isImportExcluded(imp)) continue;
+
+    let importPath;
+    if (imp.startsWith("@")) {
+      const aliasKey = Object.keys(aliases).find(a => imp.startsWith(a));
+      if (aliasKey) {
+        const relPart = imp.slice(aliasKey.length).replace(/^\/+/, "");
+        importPath = path.join(aliases[aliasKey], relPart);
+      } else continue;
+    } else importPath = path.resolve(path.dirname(filePath), imp);
+
+    const resolvedPath = tryResolveImport(importPath);
+    if (!resolvedPath || isImportExcluded(resolvedPath)) continue;
+    resolved.push(resolvedPath);
+
+    if (depth < maxDepth) {
+      const sub = await resolveJsImports(resolvedPath, visited, depth + 1, maxDepth);
+      resolved.push(...sub.files);
+    }
+  }
+
+  return { files: [...new Set(resolved)], visited };
+}

package/src/resolvers/php-bindings.js

@@ -0,0 +1,31 @@
+import fs from "fs";
+import path from "path";
+import { ROOT } from "../constants/config.js";
+
+export function loadLaravelBindings() {
+    const providersDir = path.join(ROOT, "app", "Providers");
+    const bindings = {};
+
+    if (!fs.existsSync(providersDir)) return bindings;
+
+    const files = fs
+        .readdirSync(providersDir)
+        .filter(f => f.endsWith(".php"))
+        .map(f => path.join(providersDir, f));
+
+    // 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;
+
+    for (const file of files) {
+        const code = fs.readFileSync(file, "utf8");
+        let m;
+        while ((m = re.exec(code))) {
+            const iface = m[1].replace(/\\\\/g, "\\");
+            const impl = m[2].replace(/\\\\/g, "\\");
+            bindings[iface] = impl;
+        }
+    }
+
+    return bindings;
+}

package/src/resolvers/php-resolver.js

@@ -0,0 +1,115 @@
+import fs from "fs";
+import path from "path";
+import { ROOT } from "../constants/config.js";
+import { loadLaravelBindings } from "./php-bindings.js";
+
+const debug = process.env.PRODEX_DEBUG === "1";
+const log = (...args) => { if (debug) console.log("🪶 [php-resolver]", ...args); };
+
+// --- Load Composer PSR-4 Namespaces ----------------------------------------
+
+function loadComposerNamespaces() {
+  const composerPath = path.join(ROOT, "composer.json");
+  if (!fs.existsSync(composerPath)) return {};
+  try {
+    const data = JSON.parse(fs.readFileSync(composerPath, "utf8"));
+    const psr4 = data.autoload?.["psr-4"] || {};
+    const map = {};
+    for (const ns in psr4)
+      map[ns.replace(/\\+$/, "")] = path.resolve(ROOT, psr4[ns]);
+    return map;
+  } catch {
+    return {};
+  }
+}
+
+// --- File resolver ---------------------------------------------------------
+
+function tryResolvePhpImport(basePath) {
+  if (!basePath || typeof basePath !== "string") return null;
+  const tries = [basePath, basePath + ".php", path.join(basePath, "index.php")];
+  for (const t of tries)
+    if (fs.existsSync(t) && fs.statSync(t).isFile()) return path.resolve(t);
+  return null;
+}
+
+// --- Main resolver ---------------------------------------------------------
+
+export async function resolvePhpImports(
+  filePath,
+  visited = new Set(),
+  depth = 0,
+  maxDepth = 10
+) {
+  if (visited.has(filePath)) return { files: [], visited };
+  visited.add(filePath);
+  if (!fs.existsSync(filePath)) return { files: [], visited };
+
+  const code = fs.readFileSync(filePath, "utf8");
+
+  // find include/require + grouped and single use statements
+  const patterns = [
+    /\b(?:require|include|require_once|include_once)\s*\(?['"]([^'"]+)['"]\)?/g,
+    /\buse\s+([A-Z][\w\\]+(?:\s*{[^}]+})?)/g,
+  ];
+
+  const rawMatches = new Set();
+  for (const r of patterns) {
+    let m;
+    while ((m = r.exec(code))) rawMatches.add(m[1]);
+  }
+
+  // Expand grouped uses
+  const matches = new Set();
+  for (const imp of rawMatches) {
+    const groupMatch = imp.match(/^(.+?)\s*{([^}]+)}/);
+    if (groupMatch) {
+      const base = groupMatch[1].trim().replace(/\\+$/, "");
+      const parts = groupMatch[2]
+        .split(",")
+        .map(x => x.trim())
+        .filter(Boolean);
+      for (const p of parts) matches.add(`${base}\\${p}`);
+    } else {
+      matches.add(imp.trim());
+    }
+  }
+
+  const namespaces = loadComposerNamespaces();
+  const bindings = loadLaravelBindings();
+  const resolved = [];
+
+  for (const imp0 of matches) {
+    let imp = imp0;
+
+    // Interface → Implementation mapping via Service Providers
+    if (bindings[imp]) {
+      imp = bindings[imp];
+      log("🔗 Interface resolved via AppServiceProvider:", imp0, "→", imp);
+    }
+
+    let importPath;
+
+    // PSR-4 namespace resolution
+    if (imp.includes("\\")) {
+      const nsKey = Object.keys(namespaces).find(k => imp.startsWith(k));
+      if (!nsKey) continue; // skip vendor namespaces
+      const relPart = imp.slice(nsKey.length).replace(/\\/g, "/");
+      importPath = path.join(namespaces[nsKey], `${relPart}.php`);
+    } else {
+      importPath = path.resolve(path.dirname(filePath), imp);
+    }
+
+    if (!importPath || typeof importPath !== "string") continue;
+    const resolvedPath = tryResolvePhpImport(importPath);
+    if (!resolvedPath) continue;
+    resolved.push(resolvedPath);
+
+    if (depth < maxDepth) {
+      const sub = await resolvePhpImports(resolvedPath, visited, depth + 1, maxDepth);
+      resolved.push(...sub.files);
+    }
+  }
+
+  return { files: [...new Set(resolved)], visited };
+}