prodex 1.1.0 → 1.2.0

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}`);
-}

package/dist/src/core/helpers.js

@@ -1,77 +0,0 @@
-import fs from "fs";
-import path from "path";
-import micromatch from "micromatch";
-
-/**
- * Get a root-relative version of a path.
- */
-export function rel(p, root = process.cwd()) {
-  return path.relative(root, p).replaceAll("\\", "/");
-}
-
-/**
- * Safe text read.
- */
-export function read(p) {
-  try {
-    return fs.readFileSync(p, "utf8");
-  } catch {
-    return "";
-  }
-}
-
-/**
- * Check if a path/file matches any of the provided glob patterns.
- */
-export function isExcluded(p, patterns, root = process.cwd()) {
-  if (!patterns?.length) return false;
-  const relPath = rel(p, root);
-  return micromatch.isMatch(relPath, patterns);
-}
-
-/**
- * Recursive walker that respects glob excludes.
- * Returns all files under the given directory tree.
- */
-export function* walk(dir, cfg, depth = 0) {
-  const { scanDepth, entry } = cfg;
-  const root = process.cwd();
-  if (depth > scanDepth) return;
-
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const e of entries) {
-    const full = path.join(dir, e.name);
-
-    if (e.isDirectory()) {
-      // Skip excluded directories entirely
-      const relPath = rel(full, root);
-      if (isExcluded(relPath, entry.excludes)) continue;
-      yield* walk(full, cfg, depth + 1);
-      continue;
-    }
-
-    if (e.isFile()) {
-      const relPath = rel(full, root);
-      if (isExcluded(relPath, entry.excludes)) continue;
-      yield full;
-    }
-  }
-}
-
-/**
- * Sorts files so that priority items appear first.
- */
-export function sortWithPriority(files, priorityList = []) {
-  if (!priorityList.length) return files;
-  const prioritized = [];
-  const normal = [];
-
-  for (const f of files) {
-    const normalized = f.replaceAll("\\", "/").toLowerCase();
-    if (priorityList.some(p => micromatch.isMatch(normalized, p.toLowerCase())))
-      prioritized.push(f);
-    else normal.push(f);
-  }
-
-  return [...new Set([...prioritized, ...normal])];
-}

package/dist/src/core/renderers.js

@@ -1,58 +0,0 @@
-import path from "path";
-import { read, rel } from "./helpers.js";
-import { LANG_MAP } from "../constants/render-constants.js";
-
-/**
- * Generate Markdown Table of Contents
- * Sorted alphabetically for deterministic structure.
- */
-export function tocMd(files) {
-  const sorted = [...files].sort((a, b) => a.localeCompare(b));
-  const items = sorted.map(f => "- " + rel(f)).join("\n");
-  return `# Included Source Files\n\n${items}\n\n---\n`;
-}
-
-/**
- * Render a single file section in Markdown format.
- * The first file skips the leading separator to avoid duplicates.
- */
-export function renderMd(p, isFirst = false) {
-  const rp = rel(p);
-  const ext = path.extname(p).toLowerCase();
-  const lang = LANG_MAP[ext] || "txt";
-  const code = read(p).trimEnd();
-
-  return [
-    isFirst ? "" : "---", // only add separator *after* the first file
-    `\`File: ${rp}\``,
-    "",
-    "```" + lang,
-    code,
-    "```",
-    ""
-  ]
-    .filter(Boolean)
-    .join("\n");
-}
-
-/**
- * TXT version (unchanged)
- */
-export function tocTxt(files) {
-  const sorted = [...files].sort((a, b) => a.localeCompare(b));
-  return (
-    ["##==== Combined Scope ====", ...sorted.map(f => "## - " + rel(f))].join("\n") + "\n\n"
-  );
-}
-
-export function renderTxt(p) {
-  const relPath = rel(p);
-  const code = read(p);
-  return [
-    "##==== path: " + relPath + " ====",
-    "##region " + relPath,
-    code,
-    "##endregion",
-    ""
-  ].join("\n");
-}

package/dist/src/index.js

@@ -1,15 +0,0 @@
-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();
-
-  const entryArgs = args.filter(a => !a.startsWith("--"));
-  const hasEntries = entryArgs.length > 0;
-
-  console.clear();
-  console.log("🧩 Prodex — Project Dependency Extractor\n");
-
-  await runCombine({ entries: hasEntries ? entryArgs : null });
-}