prodex 1.4.11 → 2.0.1

package/dist/types/index.js

@@ -16,6 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./config.types"), exports);
 __exportStar(require("./cli.types"), exports);
-__exportStar(require("./core.types"), exports);
+__exportStar(require("./tracing.types"), exports);
+__exportStar(require("./output.types"), exports);
 __exportStar(require("./resolver.types"), exports);
 __exportStar(require("./utils.types"), exports);
+__exportStar(require("./app.types"), exports);

package/dist/types/output.types.d.ts

@@ -0,0 +1,6 @@
+import type { ProdexConfig } from "./config.types";
+export interface OutputParams {
+    files: string[];
+    name: string;
+    cfg: ProdexConfig;
+}

package/dist/types/output.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/resolver.types.d.ts

@@ -0,0 +1,23 @@
+import type { ProdexConfig } from "./config.types";
+export interface JsResolverCtx {
+    kind: "js";
+    aliases: Record<string, string>;
+}
+export interface PhpResolverCtx {
+    kind: "php";
+    psr4: Record<string, string>;
+    nsKeys: string[];
+    bindings: Record<string, string>;
+}
+export interface ResolverParams {
+    cfg: ProdexConfig;
+    filePath: string;
+    ctx?: JsResolverCtx | PhpResolverCtx;
+}
+export interface ResolverResult {
+    files: string[];
+    stats: {
+        expected: Set<string>;
+        resolved: Set<string>;
+    };
+}

package/dist/types/tracing.types.d.ts

@@ -0,0 +1,23 @@
+import type { ProdexConfig } from "./config.types";
+export interface TraceStats {
+    expected: Set<string>;
+    resolved: Set<string>;
+}
+export interface ChainResult {
+    files: string[];
+    stats: TraceStats;
+}
+export interface TraceOptions {
+    entries: string[];
+    outputName?: string;
+}
+export interface TraceParams {
+    cfg: ProdexConfig;
+    opts: TraceOptions;
+}
+export interface TraceResult {
+    outputPath?: string;
+    entries: string[];
+    files: string[];
+    stats?: TraceStats;
+}

package/dist/types/tracing.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/utils.types.d.ts

@@ -0,0 +1,10 @@
+type LogFn = (...args: any[]) => void;
+export interface Logger {
+    debug: LogFn;
+    info: LogFn;
+    warn: LogFn;
+    error: LogFn;
+    log: LogFn;
+    clear: LogFn;
+}
+export {};

package/package.json

@@ -1,17 +1,29 @@
 {
   "name": "prodex",
-  "version": "1.4.11",
-  "description": "Unified Project Indexer & Dependency Extractor for Laravel + React + Node stacks.",
+  "version": "2.0.1",
+  "description": "Focused code-context extractor for large projects.",
   "type": "commonjs",
+  "packageManager": "npm@11.12.1",
   "bin": {
     "prodex": "./bin/prodex.js"
   },
   "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./schema": "./schema/prodex.schema.json",
+    "./package.json": "./package.json"
+  },
   "files": [
     "dist/",
     "bin/",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "schema/prodex.schema.json"
   ],
   "keywords": [
     "laravel",
@@ -24,29 +36,40 @@
     "indexer"
   ],
   "scripts": {
-    "build": "tsc",
+    "clean": "node scripts/clean-dist.js",
+    "build": "npm run clean && tsc && npm run gen:schema",
     "dev": "tsc --watch",
     "gen:schema": "node schema/generate.js",
-    "prepare": "npm run build && npm run gen:schema",
-    "d:w": "nodemon --watch dist --delay 500ms --exec node --inspect-brk dist/debug.js"
+    "check:architecture": "node scripts/check-architecture.js",
+    "test": "npm run check:architecture && npm run build && node --test test/cli-contract.test.js",
+    "prepack": "npm run build",
+    "pack:check": "npm pack --dry-run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/emxhive/prodex.git"
+  },
+  "homepage": "https://github.com/emxhive/prodex#readme",
+  "bugs": {
+    "url": "https://github.com/emxhive/prodex/issues"
   },
   "engines": {
-    "node": ">=16"
+    "node": ">=22"
   },
   "author": "emxhive",
   "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "devDependencies": {
     "@types/node": "^24.9.2",
-    "nodemon": "^3.1.10",
     "ts-json-schema-generator": "^2.4.0",
     "typescript": "^5.9.3"
   },
   "dependencies": {
     "es-module-lexer": "^1.7.0",
     "fast-glob": "^3.3.3",
-    "inquirer": "^12.10.0",
-    "micromatch": "^4.0.8",
-    "sade": "^1.8.1",
-    "source-map-support": "^0.5.21"
+    "micromatch": "^4.0.8"
   }
 }

package/schema/prodex.schema.json

@@ -0,0 +1,122 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$ref": "#/definitions/ProdexConfigFile",
+    "definitions": {
+        "ProdexConfigFile": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "$schema": {
+                    "type": "string"
+                },
+                "version": {
+                    "type": "number"
+                },
+                "output": {
+                    "$ref": "#/definitions/DeepPartial%3Cstructure-184175265-479-545-184175265-470-546-184175265-446-742-184175265-0-743%3E"
+                },
+                "entry": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "include": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "exclude": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "resolve": {
+                    "$ref": "#/definitions/DeepPartial%3Cstructure-184175265-616-696-184175265-605-697-184175265-446-742-184175265-0-743%3E"
+                },
+                "profiles": {
+                    "$ref": "#/definitions/DeepPartial%3Cindexed-type-731470504-74242-74263-731470504-74138-74264-731470504-0-218439%3Cstring%2Cdef-alias-184175265-335-446-184175265-0-743%3E%3E"
+                }
+            },
+            "required": [
+                "$schema",
+                "version"
+            ]
+        },
+        "DeepPartial<structure-184175265-479-545-184175265-470-546-184175265-446-742-184175265-0-743>": {
+            "type": "object",
+            "properties": {
+                "dir": {
+                    "type": "string"
+                },
+                "versioned": {
+                    "type": "boolean"
+                },
+                "format": {
+                    "type": "string",
+                    "enum": [
+                        "md",
+                        "txt"
+                    ]
+                }
+            },
+            "additionalProperties": false
+        },
+        "DeepPartial<structure-184175265-616-696-184175265-605-697-184175265-446-742-184175265-0-743>": {
+            "type": "object",
+            "properties": {
+                "aliases": {
+                    "$ref": "#/definitions/DeepPartial%3Cindexed-type-731470504-74242-74263-731470504-74138-74264-731470504-0-218439%3Cstring%2Cstring%3E%3E"
+                },
+                "maxDepth": {
+                    "type": "number"
+                },
+                "maxFiles": {
+                    "type": "number"
+                }
+            },
+            "additionalProperties": false
+        },
+        "DeepPartial<indexed-type-731470504-74242-74263-731470504-74138-74264-731470504-0-218439<string,string>>": {
+            "type": "object",
+            "additionalProperties": {
+                "type": "string"
+            }
+        },
+        "DeepPartial<indexed-type-731470504-74242-74263-731470504-74138-74264-731470504-0-218439<string,def-alias-184175265-335-446-184175265-0-743>>": {
+            "type": "object",
+            "additionalProperties": {
+                "$ref": "#/definitions/DeepPartial%3CProdexProfile%3E"
+            }
+        },
+        "DeepPartial<ProdexProfile>": {
+            "type": "object",
+            "properties": {
+                "name": {
+                    "type": "string"
+                },
+                "entry": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "include": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "exclude": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            },
+            "additionalProperties": false
+        }
+    }
+}

package/dist/cli/init.js

@@ -1,21 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initProdex = initProdex;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const default_config_1 = require("../constants/default-config");
-const utils_1 = require("../lib/utils");
-async function initProdex() {
-    console.log("🪄 Prodex Init — Configuration Wizard (v3");
-    const dest = path_1.default.join(process.cwd(), "prodex.json");
-    if (fs_1.default.existsSync(dest)) {
-        console.error("prodex.json already exists. Delete or modify it manually.\n");
-        return;
-    }
-    fs_1.default.writeFileSync(dest, (0, utils_1.toJson)(default_config_1.DEFAULT_PRODEX_CONFIG) + "\n", "utf8");
-    console.log(`✅ Created ${dest}`);
-    console.log("💡 Globs supported everywhere (include, exclude, priority).");
-}

package/dist/cli/picker.js

@@ -1,83 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.pickEntries = pickEntries;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const inquirer_1 = __importDefault(require("inquirer"));
-const helpers_1 = require("../core/helpers");
-const io_1 = require("../shared/io");
-const helpers_2 = require("../core/helpers");
-const collections_1 = require("../shared/collections");
-const logger_1 = require("../lib/logger");
-const prompt_1 = require("../lib/prompt");
-const questions_1 = require("../lib/questions");
-/**
- * Interactive entry picker for Prodex.
- * Handles depth-based scanning, caching, and priority ordering.
- */
-async function pickEntries(cfg) {
-    const { root, entry: { files, ui: { roots = [], priority = [], scanDepth }, }, } = cfg;
-    let depth = scanDepth;
-    const entryPatterns = files || [];
-    const priorities = [...entryPatterns, ...priority];
-    // 1️⃣ Resolve pre-defined entry patterns
-    const resolvedEntries = (await (0, helpers_2.globScan)(entryPatterns, { cwd: root })).files;
-    let selected = [...resolvedEntries];
-    // cache: depth → files[]
-    const scanCache = new Map();
-    for (;;) {
-        const files = await getFilesAtDepth(depth, cfg, scanCache);
-        // Merge resolved entries with current scan results
-        const combined = (0, collections_1.unique)([...resolvedEntries, ...files]);
-        const sorted = (0, helpers_1.orderByPriority)(combined, priorities);
-        // Build UI selection list
-        const choices = sorted.map((f) => ({
-            name: (0, io_1.rel)(f, root),
-            value: f,
-            checked: selected.includes(f),
-        }));
-        if (depth < scanDepth + 5) {
-            choices.push(new inquirer_1.default.Separator());
-            choices.push({ name: "🔽 Load more (go deeper)", value: "__loadmore" });
-        }
-        // 🧠 Use unified prompt wrapper
-        const answers = await (0, prompt_1.prompt)((0, questions_1.PICK_ENTRIES_QUESTION)(choices, depth), { picks: [] });
-        if (!answers)
-            return (0, collections_1.unique)(selected);
-        const { picks } = answers;
-        if (picks.includes("__loadmore")) {
-            depth++;
-            selected = picks.filter((p) => p !== "__loadmore");
-            continue;
-        }
-        selected = picks.filter((p) => p !== "__loadmore");
-        break;
-    }
-    return (0, collections_1.unique)(selected);
-}
-/**
- * Depth-based directory scanner with caching.
- */
-async function getFilesAtDepth(depth, cfg, scanCache) {
-    const baseDirs = cfg.entry.ui.roots || [];
-    if (scanCache.has(depth)) {
-        logger_1.logger.debug(`[picker] cache hit → depth=${depth}`);
-        return scanCache.get(depth);
-    }
-    logger_1.logger.debug(`[picker] scanning → depth=${depth}`);
-    const files = [];
-    const effectiveCfg = { ...cfg, scanDepth: depth };
-    for (const base of baseDirs) {
-        const full = path_1.default.join(cfg.root, base);
-        if (!fs_1.default.existsSync(full))
-            continue;
-        for (const f of (0, helpers_1.walk)(full, effectiveCfg, 0))
-            files.push(f.norm());
-    }
-    scanCache.set(depth, files);
-    logger_1.logger.debug(`[picker] depth=${depth} found=${files.length}`);
-    return files;
-}

package/dist/cli/summary.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.endSummary = endSummary;
-exports.introSummary = introSummary;
-exports.entrySummary = entrySummary;
-const logger_1 = require("../lib/logger");
-const io_1 = require("../shared/io");
-const store_1 = require("../store");
-let CONFIG;
-let FLAGS;
-function endSummary(out, result) {
-    logger_1.logger.debug(`🧩 Summary:
- • Unique imports expected: ${result?.stats?.expected.size}
- • Unique imports resolved: ${result?.stats?.resolved.size}
-`);
-    logger_1.logger.log(`✅ ${out.norm()}`);
-}
-function introSummary() {
-    CONFIG = (0, store_1.getConfig)();
-    FLAGS = (0, store_1.getFlags)();
-    logger_1.logger.log(`------- PRODEx RUN @ ${new Date().toLocaleTimeString()} — Codebase decoded -------\n`);
-    // Log parse results for testing
-    logger_1.logger.debug("🧩 Parsed CLI input:", _2j({ FLAGS }));
-    logger_1.logger.debug("Final merged config:", _2j(CONFIG));
-}
-function entrySummary(entries) {
-    let result = "📋 You selected:";
-    for (const e of entries)
-        result += "\n   -" + (0, io_1.rel)(e);
-    if (entries?.length)
-        logger_1.logger.log(result);
-}

package/dist/constants/config.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VALID_GLOB_CHARS = exports.SUFFIX = exports.GLOBAL_IGNORE = exports.RESOLVERS = exports.DTS_EXT = exports.REAL_EXTS = exports.BASE_EXTS = exports.CODE_EXTS = void 0;
-const js_resolver_1 = require("../resolvers/js/js-resolver");
-const php_resolver_1 = require("../resolvers/php/php-resolver");
-exports.CODE_EXTS = [".js", ".mjs", ".ts", ".tsx", ".d.ts", ".php"];
-exports.BASE_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs"];
-exports.REAL_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".d.ts", ".json"]);
-exports.DTS_EXT = ".d.ts";
-exports.RESOLVERS = {
-    ".php": php_resolver_1.resolvePhpImports,
-    ".ts": js_resolver_1.resolveJsImports,
-    ".tsx": js_resolver_1.resolveJsImports,
-    ".d.ts": js_resolver_1.resolveJsImports,
-    ".js": js_resolver_1.resolveJsImports,
-};
-exports.GLOBAL_IGNORE = ["**/node_modules/**", "**/vendor/**", "**/dist/**"];
-exports.SUFFIX = "trace";
-/**
- * Normalize and sanitize pattern fields.
- * - Always returns an array.
- * - Accepts string or string[].
- * - Splits comma-separated strings.
- * - Trims and removes empty elements.
- * - Filters out invalid or unusable characters for Fast-Glob.
- */
-exports.VALID_GLOB_CHARS = /^[\w\-@./*?|!{}\[\]^$()+]+$/;

package/dist/constants/default-config.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_PRODEX_CONFIG = void 0;
-/**
- * Default configuration for Prodex.
- * Conforms strictly to ProdexConfig for full type safety.
- */
-exports.DEFAULT_PRODEX_CONFIG = {
-    version: 3.1,
-    $schema: "https://raw.githubusercontent.com/emxhive/prodex/main/schema/prodex.schema.json",
-    output: {
-        dir: "prodex",
-        versioned: true,
-        prefix: "combined",
-        format: "md",
-    },
-    entry: {
-        files: [],
-        ui: {
-            roots: ["app", "routes", "resources/js/**"],
-            scanDepth: 2,
-            priority: ["**/routes/web.php", "**/app.*"],
-        },
-    },
-    resolve: {
-        include: ["**/*.d.ts"],
-        aliases: {
-            "@": "resources/js",
-        },
-        exclude: ["node_modules/**", "@shadcn/**", "**/components/ui/**"],
-        depth: 10,
-        limit: 200,
-    },
-    shortcuts: {
-        dashboard: {
-            files: ["**/dashboard.tsx"],
-            include: ["**.app.tsx", "**/*.d.ts"],
-        },
-        web: {
-            files: ["**/web.php", "**/api.php"],
-        },
-    },
-};

package/dist/constants/flags.js

@@ -1,79 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLI_USAGE = exports.FLAG_SHORT_MAP = exports.FLAG_MAP = void 0;
-exports.FLAG_MAP = {
-    txt: {
-        short: "t",
-        type: "boolean",
-        description: "Output as .txt instead of .md.",
-        apply: (cfg, v) => (cfg.output.format = v ? "txt" : "md"),
-    },
-    name: {
-        short: "n",
-        type: "string",
-        description: "Custom output filename (without extension).",
-        apply: (cfg, v) => (cfg.name = v),
-    },
-    limit: {
-        short: "l",
-        type: "number",
-        description: "Override traversal limit.",
-        apply: (cfg, v) => (cfg.resolve.limit = v),
-    },
-    include: {
-        short: "i",
-        type: "list",
-        description: "Comma-separated include globs.",
-        apply: (cfg, v) => (cfg.resolve.include = v),
-    },
-    exclude: {
-        short: "x",
-        type: "list",
-        description: "Comma-separated exclude globs.",
-        apply: (cfg, v) => (cfg.resolve.exclude = v),
-    },
-    files: {
-        short: "f",
-        type: "list",
-        description: "Entry files (comma-separated).",
-        apply: (cfg, v) => (cfg.entry.files = v),
-    },
-    ci: {
-        short: "c",
-        type: "boolean",
-        description: "Headless (non-interactive) mode.",
-        apply: () => { },
-    },
-    debug: {
-        short: "d",
-        type: "boolean",
-        description: "Enable debug logs.",
-        apply: () => { },
-    },
-    shortcut: {
-        short: "a",
-        type: "string",
-        description: "Apply a config shortcut by name.",
-        apply: () => { },
-    },
-    help: {
-        short: "h",
-        type: "boolean",
-        description: "Show CLI help and exit.",
-        apply: () => { },
-    },
-};
-// Reverse lookup for short aliases
-exports.FLAG_SHORT_MAP = Object.entries(exports.FLAG_MAP).reduce((acc, [k, v]) => {
-    //@ts-ignore
-    if (v.short)
-        acc[v.short] = k;
-    return acc;
-}, {});
-exports.CLI_USAGE = `
-Usage: prodex [options]
-
-${Object.entries(exports.FLAG_MAP)
-    .map(([k, v]) => `  --${k}${v.short ? ` | -${v.short}` : ""}\t${v.description}`)
-    .join("\n")}
-`;

package/dist/constants/index.js

@@ -1,20 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./cache-keys"), exports);
-__exportStar(require("./default-config"), exports);
-__exportStar(require("./render-constants"), exports);
-__exportStar(require("./config"), exports);

package/dist/core/combine.js

@@ -1,56 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runCombine = runCombine;
-const picker_1 = require("../cli/picker");
-const summary_1 = require("../cli/summary");
-const constants_1 = require("../constants");
-const cache_1 = require("./managers/cache");
-const config_1 = require("./managers/config");
-const logger_1 = require("../lib/logger");
-const dependency_1 = require("./dependency");
-const helpers_1 = require("./helpers");
-const helpers_2 = require("./helpers");
-const output_1 = require("./output");
-async function runCombine({ cfg, opts }) {
-    (0, summary_1.introSummary)();
-    const { showUi, cliName } = opts;
-    let entries = (await resolveEntries(showUi, cfg)) ?? [];
-    (0, summary_1.entrySummary)(entries);
-    let result;
-    if (!entries.length)
-        logger_1.logger.info("No entries found");
-    if (entries.length)
-        result = await (0, dependency_1.followChain)(entries, cfg);
-    const withinclude = await (0, dependency_1.applyIncludes)(cfg, result?.files ?? []);
-    if (!withinclude.length)
-        return logger_1.logger.info("No Includes found. Exiting process...");
-    const autoName = (0, helpers_2.smartNaming)(entries);
-    const outputPath = await (0, output_1.produceOutput)({ name: cliName ?? autoName, files: withinclude, cfg, showUi });
-    persistAliases();
-    (0, summary_1.endSummary)(outputPath, result);
-}
-async function resolveEntries(showUi, cfg) {
-    const { root, entry: { files }, resolve: { include }, } = cfg;
-    if (!showUi) {
-        logger_1.logger.info("CI Mode");
-        if (!files?.length) {
-            logger_1.logger.warn("No entry files defined and UI mode is disabled.");
-            if (!include.length)
-                process.exit(1);
-            logger_1.logger.info("Applying Includes");
-        }
-        return (await (0, helpers_1.globScan)(files, { cwd: root })).files;
-    }
-    else {
-        return await (0, picker_1.pickEntries)(cfg);
-    }
-}
-/**
- * 🧩 Persist discovered aliases (if any)
- */
-function persistAliases() {
-    const aliases = cache_1.CacheManager.dump(constants_1.CACHE_KEYS.ALIASES);
-    if (Object.keys(aliases).length) {
-        config_1.ConfigManager.persist({ resolve: { aliases } });
-    }
-}