prodex 1.4.11 → 2.0.0

package/dist/output/naming.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.smartNaming = smartNaming;
+exports.shortTimestamp = shortTimestamp;
+const path_1 = __importDefault(require("path"));
+function smartNaming(entries) {
+    const names = unique(entries.map((file) => path_1.default.basename(file, path_1.default.extname(file))));
+    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 "prodex";
+}
+function shortTimestamp() {
+    const d = new Date();
+    const yy = String(d.getFullYear()).slice(-2);
+    const MM = String(d.getMonth() + 1).padStart(2, "0");
+    const dd = String(d.getDate()).padStart(2, "0");
+    const hh = String(d.getHours()).padStart(2, "0");
+    const mm = String(d.getMinutes()).padStart(2, "0");
+    return `${yy}${MM}${dd}-${hh}${mm}`;
+}
+function unique(items) {
+    return [...new Set(items)];
+}

package/dist/output/produce-output.d.ts

@@ -0,0 +1,2 @@
+import type { OutputParams } from "../types";
+export declare function produceOutput({ name, files, cfg }: OutputParams): Promise<string>;

package/dist/output/produce-output.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.produceOutput = produceOutput;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const logger_1 = require("../diagnostics/logger");
+const naming_1 = require("./naming");
+const render_constants_1 = require("./render-constants");
+const markdown_1 = require("./markdown");
+const text_1 = require("./text");
+const path_2 = require("../filesystem/path");
+async function produceOutput({ name, files, cfg }) {
+    const { output: { format, versioned, dir }, } = cfg;
+    let outputBase = (0, path_2.sanitizeFileName)(name || "combined");
+    outputBase = `${outputBase}-${render_constants_1.SUFFIX}`;
+    if (versioned)
+        outputBase = `${outputBase}_${(0, naming_1.shortTimestamp)()}`;
+    const outputDir = path_1.default.isAbsolute(dir) ? dir : path_1.default.join(cfg.root, dir);
+    try {
+        fs_1.default.mkdirSync(outputDir, { recursive: true });
+    }
+    catch {
+        logger_1.logger.warn("Could not create output directory:", outputDir);
+    }
+    const outputPath = path_1.default.join(outputDir, `${outputBase}.${format}`);
+    const sorted = [...files].sort((a, b) => a.localeCompare(b));
+    const content = format === "txt"
+        ? [(0, text_1.tocTxt)(sorted, cfg.root), ...sorted.map((file) => (0, text_1.renderTxt)(file, cfg.root))].join("")
+        : (0, markdown_1.renderTraceMd)(sorted, cfg.root).content;
+    fs_1.default.writeFileSync(outputPath, content, "utf8");
+    return outputPath;
+}

package/dist/output/render-constants.d.ts

@@ -0,0 +1,21 @@
+export declare const LANG_MAP: {
+    "": string;
+    ".mjs": string;
+    ".jsx": string;
+    ".ts": string;
+    ".tsx": string;
+    ".php": string;
+    ".json": string;
+    ".d.ts": string;
+};
+export declare const TEXT_HEADERS: {
+    toc: string;
+    path: (p: any) => string;
+    regionStart: (p: any) => string;
+    regionEnd: string;
+};
+export declare const MD_FOOTER: string;
+export declare const MD_HEADER = "*Generated by [Prodex](https://github.com/emxhive/prodex#readme)*";
+export declare const INDEX_RANGE_PLACEHOLDER = "L?-L?";
+export declare const LLM_NOTE = "> Note for LLMs: `Lx-Ly` ranges refer to lines in this Prodex trace file, not the original source files. Index metadata is provided via the HTML comment markers in this section.";
+export declare const SUFFIX = "trace";

package/dist/{constants → output}/render-constants.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LLM_NOTE = exports.INDEX_RANGE_PLACEHOLDER = exports.MD_HEADER = exports.MD_FOOTER = exports.TEXT_HEADERS = exports.LANG_MAP = void 0;
+exports.SUFFIX = exports.LLM_NOTE = exports.INDEX_RANGE_PLACEHOLDER = exports.MD_HEADER = exports.MD_FOOTER = exports.TEXT_HEADERS = exports.LANG_MAP = void 0;
 const package_json_1 = __importDefault(require("../../package.json"));
 exports.LANG_MAP = {
     "": "js",
@@ -25,3 +25,4 @@ exports.MD_FOOTER = ["\n---", "*Generated with [Prodex](https://github.com/emxhi
 exports.MD_HEADER = "*Generated by [Prodex](https://github.com/emxhive/prodex#readme)*";
 exports.INDEX_RANGE_PLACEHOLDER = "L?-L?";
 exports.LLM_NOTE = "> Note for LLMs: `Lx-Ly` ranges refer to lines in this Prodex trace file, not the original source files. Index metadata is provided via the HTML comment markers in this section.";
+exports.SUFFIX = "trace";

package/dist/output/text.d.ts

@@ -0,0 +1,2 @@
+export declare function tocTxt(files: string[], root?: string): string;
+export declare function renderTxt(filePath: string, root?: string): string;

package/dist/output/text.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tocTxt = tocTxt;
+exports.renderTxt = renderTxt;
+const read_file_1 = require("../filesystem/read-file");
+function tocTxt(files, root = process.cwd()) {
+    const sorted = [...files].sort((a, b) => a.localeCompare(b));
+    return ["##==== Combined Scope ====", ...sorted.map((file) => "## - " + (0, read_file_1.rel)(file, root))].join("\n") + "\n\n";
+}
+function renderTxt(filePath, root = process.cwd()) {
+    const relativePath = (0, read_file_1.rel)(filePath, root);
+    const code = (0, read_file_1.readFileSafe)(filePath);
+    return ["##==== path: " + relativePath + " ====", "##region " + relativePath, code, "##endregion", ""].join("\n");
+}

package/dist/resolvers/js/extract-imports.d.ts

@@ -0,0 +1 @@
+export declare function extractImports(filePath: any, code: any): Promise<Set<string>>;

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

@@ -0,0 +1,2 @@
+import type { ResolverParams, ResolverResult } from "../../types";
+export declare function resolveJsImports({ cfg, filePath }: ResolverParams): Promise<ResolverResult>;

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

@@ -5,127 +5,83 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveJsImports = resolveJsImports;
 const path_1 = __importDefault(require("path"));
+const resolver_constants_1 = require("../resolver-constants");
+const cache_keys_1 = require("../../cache/cache-keys");
+const stat_cache_1 = require("../../filesystem/stat-cache");
+const logger_1 = require("../../diagnostics/logger");
+const cache_manager_1 = require("../../cache/cache-manager");
+const read_file_1 = require("../../filesystem/read-file");
+const resolver_result_1 = require("../resolver-result");
 const extract_imports_1 = require("./extract-imports");
-const config_1 = require("../../constants/config");
-const collections_1 = require("../../shared/collections");
-const logger_1 = require("../../lib/logger");
-const store_1 = require("../../store");
-const resolve_alias_1 = require("./resolve-alias"); // alias: config + cache + fast-glob
-const cache_1 = require("../../core/managers/cache");
-const cache_keys_1 = require("../../constants/cache-keys");
-const shared_1 = require("../../shared");
-const shared_2 = require("../../shared");
+const resolve_alias_1 = require("./resolve-alias");
 const { JS_STATS, JS_IMPORTS } = cache_keys_1.CACHE_KEYS;
-async function resolveJsImports({ filePath, visited = new Set(), depth = 0, maxDepth }) {
-    const limitDepth = maxDepth;
-    if (depth >= limitDepth)
-        return (0, collections_1.emptyResult)(visited);
-    if (visited.has(filePath))
-        return (0, collections_1.emptyResult)(visited);
-    visited.add(filePath);
-    const { root: ROOT, resolve: { exclude: excludePatterns }, } = (0, store_1.getConfig)();
+async function resolveJsImports({ cfg, filePath }) {
     const ext = path_1.default.extname(filePath).toLowerCase();
-    const isDts = ext === config_1.DTS_EXT;
-    if (!config_1.BASE_EXTS.includes(ext) && !isDts)
-        return (0, collections_1.emptyResult)(visited);
-    let code = (0, shared_1.readFileSafe)(filePath);
+    const isDts = ext === resolver_constants_1.DTS_EXT;
+    if (!resolver_constants_1.BASE_EXTS.includes(ext) && !isDts)
+        return (0, resolver_result_1.emptyResolverResult)();
+    const code = (0, read_file_1.readFileSafe)(filePath);
     if (!code)
-        return (0, collections_1.emptyResult)(visited);
-    // Extract imports ---------------------------------------
+        return (0, resolver_result_1.emptyResolverResult)();
     const imports = await getImportsCached(filePath, code);
     if (!imports.size)
-        return (0, collections_1.emptyResult)(visited);
-    // Trackers ----------------------------------------------
-    const stats = (0, collections_1.newStats)();
+        return (0, resolver_result_1.emptyResolverResult)();
+    const stats = (0, resolver_result_1.newResolverStats)();
     const files = [];
-    // Main resolution loop ----------------------------------
     for (const imp of imports) {
-        // skip bare packages (react, lodash, etc.)
         if (!imp.startsWith(".") && !imp.startsWith("/") && !imp.startsWith("@"))
             continue;
-        if ((0, shared_1.isExcluded)(imp, excludePatterns, ROOT))
-            continue;
-        let base = null;
-        if (imp.startsWith(".")) {
-            // relative → like original resolver
-            base = path_1.default.resolve(path_1.default.dirname(filePath), imp);
-        }
-        else if (imp.startsWith("/")) {
-            // absolute path import → like original resolver
-            base = path_1.default.resolve(imp);
-        }
-        else {
-            // alias (@...) → unified resolver (config + cache + glob)
-            base = await (0, resolve_alias_1.resolveAliasPath)(imp, ROOT, (0, store_1.getConfig)());
-        }
+        const base = await resolveImportBase(imp, filePath, cfg.root, cfg);
         if (!base)
             continue;
         const absBase = path_1.default.resolve(base);
-        // Exclusion check after alias resolution
-        if ((0, shared_1.isExcluded)(absBase, excludePatterns, ROOT))
-            continue;
         const resolvedPath = await tryResolveImport(absBase);
-        // Exclusion check after final resolution
-        if ((0, shared_1.isExcluded)(resolvedPath, excludePatterns, ROOT))
-            continue;
         stats.expected.add(absBase);
         if (!resolvedPath)
             continue;
         stats.resolved.add(absBase);
         files.push(resolvedPath);
-        // Recursive traversal
-        const sub = await resolveJsImports({
-            filePath: resolvedPath,
-            visited,
-            depth: depth + 1,
-            maxDepth: limitDepth,
-        });
-        files.push(...sub.files);
-        (0, collections_1.mergeStats)(stats, sub.stats);
     }
-    const uniqueFiles = (0, collections_1.unique)(files);
-    const diff = (0, shared_2.setDiff)(stats.expected, stats.resolved);
-    logger_1.logger.debug(`🪶 [js-resolver] ${filePath} → expected: ${stats.expected.size}, resolved: ${stats.resolved.size}`);
-    if (diff.size)
-        logger_1.logger.debug([...diff], "🔴 THE diff");
-    return { files: uniqueFiles, visited, stats };
+    const unresolved = (0, resolver_result_1.resolverSetDiff)(stats.expected, stats.resolved);
+    logger_1.logger.debug(`[js-resolver] ${filePath} -> expected: ${stats.expected.size}, resolved: ${stats.resolved.size}`);
+    if (unresolved.size)
+        logger_1.logger.debug("[js-resolver] unresolved:", [...unresolved]);
+    return { files: (0, resolver_result_1.uniqueResolvedFiles)(files), stats };
+}
+async function resolveImportBase(imp, filePath, root, cfg) {
+    if (imp.startsWith("."))
+        return path_1.default.resolve(path_1.default.dirname(filePath), imp);
+    if (imp.startsWith("/"))
+        return path_1.default.resolve(imp);
+    return (0, resolve_alias_1.resolveAliasPath)(imp, root, cfg);
 }
-// ---------------------------------------------------------
-// tryResolveImport (pure)
-// ---------------------------------------------------------
 async function tryResolveImport(basePath) {
     const candidates = [];
     const ext = path_1.default.extname(basePath).toLowerCase();
-    if (ext && config_1.REAL_EXTS.has(ext)) {
+    if (ext && resolver_constants_1.REAL_EXTS.has(ext)) {
         candidates.push(basePath);
     }
     else {
-        for (const e of [...config_1.BASE_EXTS, config_1.DTS_EXT]) {
-            candidates.push(basePath + e);
-            candidates.push(path_1.default.join(basePath, "index" + e));
+        for (const candidateExt of [...resolver_constants_1.BASE_EXTS, resolver_constants_1.DTS_EXT]) {
+            candidates.push(basePath + candidateExt);
+            candidates.push(path_1.default.join(basePath, "index" + candidateExt));
         }
     }
-    // Run all stat checks in parallel
-    const results = await Promise.allSettled(candidates.map(async (c) => {
-        const abs = path_1.default.resolve(c);
-        const st = await (0, shared_1.safeStatCached)(JS_STATS, abs);
-        return st && st.isFile() ? abs : null;
+    const results = await Promise.allSettled(candidates.map(async (candidate) => {
+        const abs = path_1.default.resolve(candidate);
+        const stats = await (0, stat_cache_1.safeStatCached)(JS_STATS, abs);
+        return stats?.isFile() ? abs : null;
     }));
-    // Find the first fulfilled non-null result
-    for (const r of results) {
-        if (r.status === "fulfilled" && r.value)
-            return r.value;
-    }
-    return null;
+    return results.find(isFulfilledPath)?.value ?? null;
 }
-// ---------------------------------------------------------
-// Cached stat + import scanners
-// ---------------------------------------------------------
 async function getImportsCached(filePath, code) {
-    const cached = cache_1.CacheManager.get(JS_IMPORTS, filePath);
+    const cached = cache_manager_1.CacheManager.get(JS_IMPORTS, filePath);
     if (cached)
         return cached;
-    const set = await (0, extract_imports_1.extractImports)(filePath, code);
-    cache_1.CacheManager.set(JS_IMPORTS, filePath, set);
-    return set;
+    const imports = await (0, extract_imports_1.extractImports)(filePath, code);
+    cache_manager_1.CacheManager.set(JS_IMPORTS, filePath, imports);
+    return imports;
+}
+function isFulfilledPath(result) {
+    return result.status === "fulfilled" && !!result.value;
 }

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

@@ -0,0 +1,2 @@
+import type { ProdexConfig } from "../../types";
+export declare function resolveAliasPath(specifier: string, root: string, cfg: ProdexConfig): Promise<string | null>;

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

@@ -5,18 +5,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveAliasPath = resolveAliasPath;
 const path_1 = __importDefault(require("path"));
-const cache_1 = require("../../core/managers/cache");
-const constants_1 = require("../../constants");
-const helpers_1 = require("../../core/helpers");
-const shared_1 = require("../../shared");
-/**
- * 🧩 resolveAliasPath()
- * Unifies alias lookup across config, cache, and fallback discovery.
- *
- * - Checks cfg.resolve.aliases first.
- * - Then cached aliases (from Cache Manager).
- * - If still unresolved, runs Fast-Glob to discover and cache new alias root.
- */
+const cache_manager_1 = require("../../cache/cache-manager");
+const cache_keys_1 = require("../../cache/cache-keys");
+const glob_scan_1 = require("../../filesystem/glob-scan");
+const read_file_1 = require("../../filesystem/read-file");
+const path_2 = require("../../filesystem/path");
 async function resolveAliasPath(specifier, root, cfg) {
     if (!specifier.includes("/"))
         return null;
@@ -30,31 +23,30 @@ async function resolveAliasPath(specifier, root, cfg) {
         return path_1.default.resolve(root, knownAliases[aliasKey], relPart);
     }
     // 2️⃣ Check cached aliases
-    const cached = cache_1.CacheManager.get(constants_1.CACHE_KEYS.ALIASES, aliasKey);
+    const cached = cache_manager_1.CacheManager.get(cache_keys_1.CACHE_KEYS.ALIASES, aliasKey);
     if (cached) {
         const relPart = remainder.replace(/^\/+/, "");
         return path_1.default.resolve(root, cached, relPart);
     }
     // 3️⃣ Fallback discovery with Fast-Glob
-    const stripped = remainder; // remove prefix before first '/'
+    const stripped = remainder;
     const hasExt = /\.[a-z0-9]+$/i.test(stripped);
     const patterns = hasExt ? [`**/${stripped}`] : [`**/${stripped}.*`, `**/${stripped}/index.*`];
-    const { files: matches } = await (0, helpers_1.globScan)(patterns, { cwd: root });
+    const { files: matches } = await (0, glob_scan_1.globScan)(patterns, { cwd: root });
     if (matches.length) {
         const resolvedMatch = resolveMatches(matches, remainder);
-        // .replace(/\.[^/.]+$/, "")
         if (!resolvedMatch)
             return null;
-        const relPath = (0, shared_1.rel)(resolvedMatch, cfg.root);
-        cache_1.CacheManager.set(constants_1.CACHE_KEYS.ALIASES, aliasKey, relPath);
+        const relPath = (0, read_file_1.rel)(resolvedMatch, cfg.root);
+        cache_manager_1.CacheManager.set(cache_keys_1.CACHE_KEYS.ALIASES, aliasKey, relPath);
         return relPath;
     }
     return null;
 }
 function resolveMatches(matches, remainder) {
-    const foundFile = matches[0].norm();
+    const foundFile = (0, path_2.normalizePath)(matches[0]);
     const dSplit = foundFile.split(remainder);
     if (dSplit.length < 2)
         return "";
-    return dSplit[0].replace(/\\/g, "/");
+    return (0, path_2.normalizePath)(dSplit[0]);
 }

package/dist/resolvers/php/bindings.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Scans app/Providers/*.php for $this->app->bind() / singleton() calls
+ * and returns a map of InterfaceFQCN to ImplementationFQCN.
+ *
+ * Uses existing extractPhpImports + expandGroupedUses to correctly
+ * resolve namespaces and short class names.
+ */
+export declare function loadLaravelBindings(root: string): Record<string, string>;

package/dist/resolvers/php/bindings.js

@@ -6,25 +6,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadLaravelBindings = loadLaravelBindings;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const cache_1 = require("../../core/managers/cache");
-const cache_keys_1 = require("../../constants/cache-keys");
+const cache_manager_1 = require("../../cache/cache-manager");
+const cache_keys_1 = require("../../cache/cache-keys");
 const extract_imports_1 = require("./extract-imports");
-const logger_1 = require("../../lib/logger");
+const logger_1 = require("../../diagnostics/logger");
 /**
  * Scans app/Providers/*.php for $this->app->bind() / singleton() calls
- * and returns a map of InterfaceFQCN → ImplementationFQCN.
+ * and returns a map of InterfaceFQCN to ImplementationFQCN.
  *
  * Uses existing extractPhpImports + expandGroupedUses to correctly
  * resolve namespaces and short class names.
  */
 function loadLaravelBindings(root) {
-    const cached = cache_1.CacheManager.get(cache_keys_1.CACHE_KEYS.PHP_BINDINGS, root);
+    const cached = cache_manager_1.CacheManager.get(cache_keys_1.CACHE_KEYS.PHP_BINDINGS, root);
     if (cached)
         return cached;
     const providersDir = path_1.default.join(root, "app", "Providers");
     const bindings = {};
     if (!fs_1.default.existsSync(providersDir)) {
-        cache_1.CacheManager.set(cache_keys_1.CACHE_KEYS.PHP_BINDINGS, root, bindings);
+        cache_manager_1.CacheManager.set(cache_keys_1.CACHE_KEYS.PHP_BINDINGS, root, bindings);
         return bindings;
     }
     const files = fs_1.default
@@ -36,7 +36,6 @@ function loadLaravelBindings(root) {
         // 1️⃣ Extract all imports in the provider
         const rawImports = (0, extract_imports_1.extractPhpImports)(code);
         const expanded = (0, extract_imports_1.expandGroupedUses)(rawImports);
-        // Build ShortName → FQCN map
         const importMap = {};
         for (const fqcn of expanded) {
             const short = fqcn.split("\\").pop();
@@ -50,10 +49,10 @@ function loadLaravelBindings(root) {
             const implShort = m[2];
             const ifaceFull = importMap[ifaceShort] || ifaceShort;
             const implFull = importMap[implShort] || implShort;
-            logger_1.logger.debug(`[laravel-bindings] ${file} => ${ifaceFull} → ${implFull}`);
+            logger_1.logger.debug(`[laravel-bindings] ${file} => ${ifaceFull} => ${implFull}`);
             bindings[ifaceFull] = implFull;
         }
     }
-    cache_1.CacheManager.set(cache_keys_1.CACHE_KEYS.PHP_BINDINGS, root, bindings);
+    cache_manager_1.CacheManager.set(cache_keys_1.CACHE_KEYS.PHP_BINDINGS, root, bindings);
     return bindings;
 }

package/dist/resolvers/php/extract-imports.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Extracts import-like references from PHP code.
+ * Supports:
+ *  - require/include/require_once/include_once
+ *  - use statements (including grouped imports like `use App\Models\{User, Team};`)
+ */
+export declare function extractPhpImports(code: string): Set<string>;
+/**
+ * Expands grouped `use` imports into individual fully qualified names.
+ * Example:
+ *   "App\\Models\\{User, Team}" to ["App\\Models\\User", "App\\Models\\Team"]
+ */
+export declare function expandGroupedUses(raw: Set<string>): Set<string>;

package/dist/resolvers/php/extract-imports.js

@@ -41,7 +41,7 @@ function extractPhpImports(code) {
 /**
  * Expands grouped `use` imports into individual fully qualified names.
  * Example:
- *   "App\\Models\\{User, Team}" → ["App\\Models\\User", "App\\Models\\Team"]
+ *   "App\\Models\\{User, Team}" to ["App\\Models\\User", "App\\Models\\Team"]
  */
 function expandGroupedUses(raw) {
     const out = new Set();

package/dist/resolvers/php/php-resolver.d.ts

@@ -0,0 +1,2 @@
+import type { ResolverParams, ResolverResult } from "../../types";
+export declare function resolvePhpImports({ cfg, filePath, ctx }: ResolverParams): Promise<ResolverResult>;