prodex 1.1.0 → 1.3.0

package/dist/LICENSE

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

@@ -1,140 +0,0 @@
-# 🧩 Prodex — Unified Project Indexer & Dependency Extractor
-
-> **Prodex** *(short for “Project Index”)* — a cross-language dependency combiner for modern full-stack applications.  
-> Traverses **Laravel + React + TypeScript** projects to generate a single, organized view of your project’s true dependency scope.
-
----
-
-## 🧠 Recent Fixes & Updates — v1.0.8
-- ⭐ **Priority Files Support**  — priority files will now appear **first** on the entry selection list.
-
-- 🪟 **Windows path resolution fixed** — now uses proper `file://` URLs for full ESM compatibility.  
-- 🧾 **Improved output naming** — automatic, context-aware filenames (e.g. `prodex-[entries]-combined.txt`).  
-- ⚙️ **“Yes to all” confirmation added** — skip repetitive prompts during CLI runs.
-
----
-
----
-
-## 📦 Installation
-
-### Global install (recommended)
-```bash
-npm install -g prodex
-```
-
-
-## 🚀 Features
-
-| Feature | Description |
-|----------|-------------|
-| ⚙️ **Cross-language resolver** | Parses JS/TS (`import`, `export`) and PHP (`use`, `require`, `include`) dependency trees. |
-| 🧭 **Alias detection** | Reads `tsconfig.json` and `vite.config.*` for alias paths (`@/components/...`). |
-| 🧩 **Laravel-aware** | Maps PSR-4 namespaces and detects providers under `app/Providers`. |
-| 🔄 **Recursive chain following** | Resolves dependency graphs up to a configurable depth and file limit. |
-| 🪶 **Clean unified output** | Merges all resolved files into a single `.txt` file with region markers for readability. |
-| 🧠 **Static & safe** | Fully static parsing — no runtime execution or file modification. |
-| 💬 **Interactive CLI** | Select files, confirm settings, or use “Yes to all” for streamlined automation. |
-
----
-
-## ⚙️ Configuration
-
-Optional `.prodex.json` (in project root):
-
-```json
-{
-  "$schema": "https://raw.githubusercontent.com/emxhive/prodex/main/schema/prodex.schema.json",
-  "output": "prodex",
-  "scanDepth": 2,
-  "limit": 200,
-  "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/"
-  ], 
-  "priorityFiles": [
-  "routes/web.php",
-  "routes/api.php",
-  "index.",
-  "main.",
-  "app."
-]
-}
-```
-
-```
-
-
-
-```
-
-
-
-Files are matched using `.includes()` (case-insensitive), so `"index."` will match `src/index.js`, `app/index.tsx`, etc.  
-Popular entries appear at the top of the picker.
-
-
-
-
-
----
-
-## 🧱 Example: Laravel + React
-
-```bash
-prodex
-```
-
-```
-🧩 Following dependency chain...
-✅ prodex-app-routes-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
-
-- 📦 Generate single-file **project snapshots**  
-- 🤖 Provide structured context for **AI assistants**  
-- 🧩 Perform **dependency audits** or code reviews  
-- 📄 Simplify documentation and onboarding  
-
----
-
-## 🔮 Upcoming Features
-
-- 📝 **Markdown export** (`.md`) with automatic code fences  
-- 📦 **Configurable output formats** (txt / md)  
-- ⚡ **Alias auto-discovery for Laravel Mix and Next.js**  
-
----
-
-## 🧾 License
-
-**MIT © 2025 [emxhive](https://github.com/emxhive)**  
-Issues and contributions welcome:  
-👉 [github.com/emxhive/prodex/issues](https://github.com/emxhive/prodex/issues)
-
----
-
-**Prodex** — *Codebase, decoded*
-

package/dist/bin/prodex.js

@@ -1,18 +0,0 @@
-#!/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/src/index.js");
-
-// prefer dist in published package
-const entry = fs.existsSync(distPath) ? distPath : devPath;
-
-// convert to file:// URL for cross-platform ESM loading
-const entryUrl = pathToFileURL(entry).href;
-
-import(entryUrl).then(({ default: startProdex }) => startProdex());

package/dist/package.json

@@ -1,45 +0,0 @@
-{
-  "name": "prodex",
-  "version": "1.1.0",
-  "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 && node -e \"require('fs').mkdirSync('dist',{recursive:true})\" && cp -r src bin package.json README.md LICENSE dist/",
-    "prepare": "npm run build"
-  },
-  "author": "emxhive",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^24.9.1",
-    "tsup": "^8.5.0",
-    "typescript": "^5.9.3"
-  },
-  "dependencies": {
-    "inquirer": "^12.10.0",
-    "micromatch": "^4.0.8"
-  }
-}

package/dist/src/cli/init.js

@@ -1,18 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { DEFAULT_PRODEX_CONFIG } from "../constants/default-config.js";
-
-export async function initProdex() {
-  console.log("🪄 Prodex Init — Configuration Wizard (v2)\n");
-
-  const dest = path.join(process.cwd(), "prodex.json");
-
-  if (fs.existsSync(dest)) {
-    console.log("❌ prodex.json already exists. Delete or modify it manually.\n");
-    return;
-  }
-
-  fs.writeFileSync(dest, JSON.stringify(DEFAULT_PRODEX_CONFIG, null, 2) + "\n", "utf8");
-  console.log(`✅ Created ${dest}`);
-  console.log("💡 Globs supported everywhere (includes, excludes, priority).");
-}

package/dist/src/cli/picker.js

@@ -1,59 +0,0 @@
-import fs from "fs";
-import path from "path";
-import inquirer from "inquirer";
-import { ROOT } from "../constants/config.js";
-import { walk, rel, sortWithPriority } from "../core/helpers.js";
-
-/**
- * Prodex v2 picker
- * - Keeps "Load more" (depth++)
- * - Removes manual path entry
- * - Uses cfg.entry.includes / cfg.entry.priority
- */
-export async function pickEntries(baseDirs, depth = 2, cfg = {}) {
-  let selected = [];
-
-  while (true) {
-    const files = [];
-
-    // Use an effective cfg that reflects the current depth for this iteration
-    const effectiveCfg = { ...cfg, scanDepth: depth };
-
-    for (const base of baseDirs) {
-      const full = path.join(ROOT, base);
-      if (!fs.existsSync(full)) continue;
-      for (const f of walk(full, effectiveCfg, 0)) files.push(f);
-    }
-
-    // Priority-aware ordering
-    const sorted = sortWithPriority(files, cfg.entry?.priority || []);
-
-    // Build choices + the "Load more" control
-    const choices = sorted.map(f => ({ name: rel(f), value: f }));
-    choices.push(new inquirer.Separator());
-    choices.push({ name: "🔽 Load more (go deeper)", value: "__loadmore" });
-
-    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("__loadmore")) {
-      depth++;
-      selected = picks.filter(p => p !== "__loadmore");
-      continue;
-    }
-
-    selected = picks.filter(p => p !== "__loadmore");
-    break;
-  }
-
-  return [...new Set(selected)];
-}

package/dist/src/cli/summary.js

@@ -1,6 +0,0 @@
-export function showSummary({ outDir, fileName, entries }) {
-  console.log("\n🧩 Active Run:");
-  console.log(" • Output Directory:", outDir);
-  console.log(" • File Name:", fileName);
-  console.log(" • Entries:", entries.length);
-}

package/dist/src/constants/config-loader.js

@@ -1,87 +0,0 @@
-import fs from "fs";
-import path from "path";
-import micromatch from "micromatch";
-import { DEFAULT_PRODEX_CONFIG } from "./default-config.js";
-
-export function loadProdexConfig() {
-  const ROOT = process.cwd();
-  const configPath = path.join(ROOT, "prodex.json");
-  
-if (!fs.existsSync(configPath)) {
-  console.log("🪄 No prodex.json found — generating default config...\n");
-  fs.writeFileSync(configPath, JSON.stringify(DEFAULT_PRODEX_CONFIG, null, 2) + "\n", "utf8");
-}
-  let raw;
-  try {
-    raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
-  } catch (err) {
-    throw new Error(`❌ Invalid prodex.json: ${err.message}`);
-  }
-
-  const cfg = {
-    outDir: path.resolve(ROOT, raw.outDir || "prodex"),
-    scanDepth: raw.scanDepth ?? 2,
-    limit: raw.limit ?? 200,
-
-    entry: {
-      includes: toArray(raw.entry?.includes ?? []),
-      excludes: toArray(raw.entry?.excludes ?? []),
-      priority: toArray(raw.entry?.priority ?? [])
-    },
-
-    imports: {
-      includes: toArray(raw.imports?.includes ?? []),
-      excludes: toArray(raw.imports?.excludes ?? []),
-      aliases: raw.imports?.aliases ?? {}
-    }
-  };
-
-  ensureDir(cfg.outDir);
-
-  // // === Validation summary ===
-  // console.log("🧩 Prodex Config Loaded\n");
-  // console.log(" • outDir Dir:", cfg.outDir);
-  // console.log(" • Entry Includes:", shortList(cfg.entry.includes));
-  // console.log(" • Entry Excludes:", shortList(cfg.entry.excludes));
-  // console.log(" • Import Includes:", shortList(cfg.imports.includes));
-  // console.log(" • Import Excludes:", shortList(cfg.imports.excludes));
-  // console.log(" • Aliases:", Object.keys(cfg.imports.aliases).length);
-
-  return cfg;
-}
-
-/**
- * Utility — ensures array normalization.
- */
-function toArray(v) {
-  return Array.isArray(v) ? v : v ? [v] : [];
-}
-
-/**
- * Utility — ensure directory exists.
- */
-function ensureDir(p) {
-  try {
-    fs.mkdirSync(p, { recursive: true });
-  } catch {
-    console.warn("⚠️  Could not create outDir directory:", p);
-  }
-}
-
-/**
- * Utility — shortens list for display.
- */
-function shortList(list) {
-  if (!list.length) return "(none)";
-  return list.length > 3 ? list.slice(0, 3).join(", ") + "..." : list.join(", ");
-}
-
-/**
- * Glob matcher factory
- * Creates helpers for downstream modules.
- */
-export function makeGlobChecker(patterns) {
-  const safe = toArray(patterns);
-  if (!safe.length) return () => false;
-  return (input) => micromatch.isMatch(input.replaceAll("\\", "/"), safe);
-}

package/dist/src/constants/config.js

@@ -1,13 +0,0 @@
-export const ROOT = process.cwd();
-export const CODE_EXTS = [".js", ".mjs", ".ts", ".tsx", ".d.ts", ".php"];
-
-import { resolveJsImports } from "../resolvers/js-resolver.js";
-import { resolvePhpImports } from "../resolvers/php-resolver.js";
-
-export const RESOLVERS = {
-  ".php": resolvePhpImports,
-  ".ts": resolveJsImports,
-  ".tsx": resolveJsImports,
-  ".d.ts": resolveJsImports,
-  ".js": resolveJsImports
-};

package/dist/src/constants/default-config.js

@@ -1,36 +0,0 @@
-export const DEFAULT_PRODEX_CONFIG = {
-  $schema: "https://raw.githubusercontent.com/emxhive/prodex/main/schema/prodex.schema.json",
-  outDir: "prodex",
-  scanDepth: 2,
-  limit: 200,
-  resolverDepth: 10,
-
-  entry: {
-    includes: ["app", "routes", "resources/js"],
-    excludes: [
-      "**/components/ui/**",
-      "**/DTOs/**",
-      "**/Enums/**"
-    ],
-    priority: [
-      "**/routes/web.php",
-      "**/routes/api.php",
-      "**/*index.*",
-      "**/*main.*",
-      "**/app.*"
-    ]
-  },
-
-  imports: {
-    includes: ["**/*.d.ts", "**/*.interface.ts"],
-    excludes: [
-      "node_modules/**",
-      "@shadcn/**",
-      "**/components/ui/**"
-    ],
-    aliases: {
-      "@hooks": "resources/js/hooks",
-      "@data": "resources/js/data"
-    }
-  }
-};

package/dist/src/constants/render-constants.js

@@ -1,22 +0,0 @@
-// ================================================================
-// 🧩 Prodex — Render Constants
-// Defines shared constants for renderer outDir formats.
-// ================================================================
-
-export const LANG_MAP = {
-  ".js": "js",
-  ".mjs": "js",
-  ".jsx": "jsx",
-  ".ts": "ts",
-  ".tsx": "tsx",
-  ".php": "php",
-  ".json": "json",
-  ".d.ts": "ts"
-};
-
-export const TEXT_HEADERS = {
-  toc: "##==== Combined Scope ====",
-  path: p => `##==== path: ${p} ====`,
-  regionStart: p => `##region ${p}`,
-  regionEnd: "##endregion"
-};

package/dist/src/core/alias-loader.js

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

package/dist/src/core/combine.js

@@ -1,145 +0,0 @@
-import fs from "fs";
-import inquirer from "inquirer";
-import path from "path";
-import micromatch from "micromatch";
-import { pickEntries } from "../cli/picker.js";
-import { showSummary } from "../cli/summary.js";
-import { loadProdexConfig } from "../constants/config-loader.js";
-import { CODE_EXTS, RESOLVERS, ROOT } from "../constants/config.js";
-import { generateOutputName, resolveOutDirPath, safeMicromatchScan } from "./file-utils.js";
-import { renderMd, renderTxt, tocMd, tocTxt } from "./renderers.js";
-
-
-export async function runCombine(opts = {}) {
-  const cliLimitFlag = process.argv.find(arg => arg.startsWith("--limit="));
-  const customLimit = cliLimitFlag ? parseInt(cliLimitFlag.split("=")[1], 10) : null;
-  const cliTxtFlag = process.argv.includes("--txt");
-
-  const cfg = loadProdexConfig();
-  const { scanDepth } = cfg;
-
-  let entries = opts.entries;
-
-  // 🧩 Headless mode: expand globs manually
-  if (entries && entries.length) {
-    const all = [];
-    for (const pattern of entries) {
-      const abs = path.resolve(process.cwd(), pattern);
-      if (fs.existsSync(abs) && fs.statSync(abs).isFile()) {
-        // direct file path (no glob)
-        all.push(abs);
-        continue;
-      }
-
-      // glob pattern
-      const result = safeMicromatchScan(pattern, {
-        cwd: process.cwd(),
-        absolute: true,
-      });
-      if (result?.files?.length) all.push(...result.files);
-    }
-    entries = [...new Set(all)];
-  } else {
-    // fallback to interactive picker
-    entries = await pickEntries(cfg.entry.includes, scanDepth, cfg);
-  }
-
-
-  if (!entries.length) {
-    console.log("❌ No entries selected.");
-    return;
-  }
-
-  console.log("\n📋 You selected:");
-  for (const e of entries) console.log(" -", e.replace(ROOT + "/", ""));
-
-  // 🧩 Auto name suggestion
-  const autoName = generateOutputName(entries);
-  const outDir = cfg.outDir || path.join(ROOT, "prodex");
-  const limit = customLimit || cfg.limit || 200;
-  const chain = true;
-
-  // Skip prompt if entries were passed directly
-  let outputBase = autoName;
-  if (!opts.entries?.length) {
-    const { outputBase: answer } = await inquirer.prompt([
-      {
-        type: "input",
-        name: "outputBase",
-        message: "Output file name (without extension):",
-        default: autoName,
-        filter: v => (v.trim() || autoName).replace(/[<>:"/\\|?*]+/g, "_"),
-      },
-    ]);
-    outputBase = answer;
-  }
-
-  // Ensure output directory exists
-  try {
-    fs.mkdirSync(outDir, { recursive: true });
-  } catch {
-    console.warn("⚠️  Could not create outDir directory:", outDir);
-  }
-
-  const outputPath = resolveOutDirPath(outDir, outputBase, cliTxtFlag);
-
-  showSummary({ outDir, fileName: path.basename(outputPath), entries });
-
-
-  const result = chain ? await followChain(entries, cfg, limit) : { files: entries, stats: { totalImports: 0, totalResolved: 0 } };
-  const sorted = [...result.files].sort((a, b) => a.localeCompare(b));
-
-  const content = cliTxtFlag
-    ? [tocTxt(sorted), ...sorted.map(renderTxt)].join("")
-    : [tocMd(sorted), ...sorted.map((f, i) => renderMd(f, i === 0))].join("\n");
-
-  fs.writeFileSync(outputPath, content, "utf8");
-  console.log(
-    `\n✅ ${outputPath}`
-  );
-  // 🧩 Print resolver summary (clean version)
-  console.log(`\n🧩 Summary:
- • Unique imports expected: ${result.stats.expected.size}
- • Unique imports resolved: ${result.stats.resolved.size}
-`);
-}
-
-async function followChain(entryFiles, cfg, limit = 200) {
-  console.log("🧩 Following dependency chain...");
-  const visited = new Set();
-  const all = [];
-  const expected = new Set();
-  const resolved = new Set();
-  const resolverDepth = cfg.resolverDepth ?? 10;
-
-  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 result = await resolver(f, cfg, visited, 0, resolverDepth);
-      const { files, stats } = result;
-      all.push(...files);
-      stats?.expected?.forEach(x => expected.add(x));
-      stats?.resolved?.forEach(x => resolved.add(x));
-    }
-
-    if (limit && all.length >= limit) {
-      console.log("⚠️  Limit reached:", limit);
-      break;
-    }
-  }
-
-  return {
-    files: [...new Set(all)],
-    stats: {
-      expected,
-      resolved
-    }
-  };
-}
-

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

@@ -1,45 +0,0 @@
-import fs from "fs";
-import path from "path";
-import micromatch from "micromatch";
-
-/**
- * Safe micromatch.scan wrapper (compatible with micromatch v4 & v5)
- */
-export function safeMicromatchScan(pattern, opts = {}) {
-  const scanFn = micromatch.scan;
-  if (typeof scanFn === "function") return scanFn(pattern, opts);
-
-  // --- fallback for micromatch v4 ---
-  const cwd = opts.cwd || process.cwd();
-  const abs = !!opts.absolute;
-  const allFiles = listAllFiles(cwd);
-  const matched = micromatch.match(allFiles, pattern, { dot: true });
-  return { files: abs ? matched.map(f => path.resolve(cwd, f)) : matched };
-}
-
-/**
- * Recursively list all files in a directory.
- * Used only for fallback (so performance isn’t critical).
- */
-function listAllFiles(dir) {
-  const out = [];
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) out.push(...listAllFiles(full));
-    else out.push(full);
-  }
-  return out;
-}
-
-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 resolveOutDirPath(outDir, base, asTxt = false) {
-  const ext = asTxt ? "txt" : "md";
-  return path.join(outDir, `${base}-combined.${ext}`);
-}