prodex 2.0.1 → 2.1.0

package/schema/prodex.schema.json

@@ -4,7 +4,6 @@
     "definitions": {
         "ProdexConfigFile": {
             "type": "object",
-            "additionalProperties": false,
             "properties": {
                 "$schema": {
                     "type": "string"
@@ -13,39 +12,40 @@
                     "type": "number"
                 },
                 "output": {
-                    "$ref": "#/definitions/DeepPartial%3Cstructure-184175265-479-545-184175265-470-546-184175265-446-742-184175265-0-743%3E"
+                    "$ref": "#/definitions/ProdexConfigFileOutput"
                 },
-                "entry": {
+                "exclude": {
                     "type": "array",
                     "items": {
                         "type": "string"
                     }
                 },
-                "include": {
-                    "type": "array",
-                    "items": {
+                "aliases": {
+                    "type": "object",
+                    "additionalProperties": {
                         "type": "string"
                     }
                 },
-                "exclude": {
-                    "type": "array",
-                    "items": {
-                        "type": "string"
-                    }
+                "depth": {
+                    "type": "number"
                 },
-                "resolve": {
-                    "$ref": "#/definitions/DeepPartial%3Cstructure-184175265-616-696-184175265-605-697-184175265-446-742-184175265-0-743%3E"
+                "maxFiles": {
+                    "type": "number"
                 },
-                "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"
+                "scopes": {
+                    "type": "object",
+                    "additionalProperties": {
+                        "$ref": "#/definitions/ProdexScope"
+                    }
                 }
             },
             "required": [
                 "$schema",
                 "version"
-            ]
+            ],
+            "additionalProperties": false
         },
-        "DeepPartial<structure-184175265-479-545-184175265-470-546-184175265-446-742-184175265-0-743>": {
+        "ProdexConfigFileOutput": {
             "type": "object",
             "properties": {
                 "dir": {
@@ -64,52 +64,70 @@
             },
             "additionalProperties": false
         },
-        "DeepPartial<structure-184175265-616-696-184175265-605-697-184175265-446-742-184175265-0-743>": {
+        "ProdexScope": {
             "type": "object",
             "properties": {
-                "aliases": {
-                    "$ref": "#/definitions/DeepPartial%3Cindexed-type-731470504-74242-74263-731470504-74138-74264-731470504-0-218439%3Cstring%2Cstring%3E%3E"
+                "name": {
+                    "type": "string"
                 },
-                "maxDepth": {
-                    "type": "number"
+                "entry": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
                 },
-                "maxFiles": {
-                    "type": "number"
+                "include": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "exclude": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "grep": {
+                    "$ref": "#/definitions/ProdexGrepScopeConfig"
                 }
             },
             "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>": {
+        "ProdexGrepScopeConfig": {
             "type": "object",
             "properties": {
-                "name": {
+                "query": {
                     "type": "string"
                 },
-                "entry": {
+                "any": {
                     "type": "array",
                     "items": {
                         "type": "string"
                     }
                 },
-                "include": {
+                "all": {
                     "type": "array",
                     "items": {
                         "type": "string"
                     }
                 },
-                "exclude": {
+                "regex": {
+                    "type": "string"
+                },
+                "not": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "within": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "skip": {
                     "type": "array",
                     "items": {
                         "type": "string"

package/dist/app/run-plans.d.ts

@@ -1,11 +0,0 @@
-import type { ProdexFlags, RunPlan } from "../types";
-export interface CreateRunPlansResult {
-    plans: RunPlan[];
-    warnings: string[];
-    errors: string[];
-}
-export declare function createRunPlans(params: {
-    rootArg?: string;
-    flags?: Partial<ProdexFlags>;
-    cwd?: string;
-}): CreateRunPlansResult;

package/dist/app/run-plans.js

@@ -1,61 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createRunPlans = createRunPlans;
-const build_config_1 = require("../config/build-config");
-const project_context_1 = require("./project-context");
-function createRunPlans(params) {
-    const project = (0, project_context_1.loadProjectContext)(params.rootArg, params.cwd);
-    const warnings = [...project.warnings];
-    const errors = [...project.errors];
-    const flags = params.flags ?? {};
-    if (errors.length)
-        return { plans: [], warnings, errors };
-    const profileNames = resolveProfileNames(flags, project.config.profiles ?? {}, errors);
-    if (errors.length)
-        return { plans: [], warnings, errors };
-    const plans = [];
-    for (const profileName of profileNames.length ? profileNames : [undefined]) {
-        const runFlags = flagsForProfileRun(flags, profileName);
-        const built = (0, build_config_1.buildConfig)({
-            root: project.root,
-            userConfig: project.config,
-            flags: runFlags,
-            profileName,
-        });
-        warnings.push(...built.warnings);
-        errors.push(...built.errors);
-        if (!built.config)
-            continue;
-        plans.push({
-            root: project.root,
-            config: built.config,
-            flags: runFlags,
-            outputName: built.config.name,
-            profile: profileName,
-        });
-    }
-    return { plans, warnings, errors };
-}
-function resolveProfileNames(flags, profiles, errors) {
-    if (flags.allProfiles) {
-        const names = Object.keys(profiles);
-        if (!names.length)
-            errors.push("No profiles are defined in prodex.json.");
-        return names;
-    }
-    if (Array.isArray(flags.profiles) && flags.profiles.length)
-        return unique(flags.profiles);
-    return [];
-}
-function flagsForProfileRun(flags, profile) {
-    if (!profile)
-        return flags;
-    return {
-        ...flags,
-        profiles: undefined,
-        allProfiles: false,
-    };
-}
-function unique(values) {
-    return [...new Set(values.map((value) => value.trim()).filter(Boolean))];
-}

package/dist/commands/profiles-command.d.ts

@@ -1,6 +0,0 @@
-export interface ProfilesCommandResult {
-    profiles: string[];
-    warnings: string[];
-    errors: string[];
-}
-export declare function profilesCommand(rootArg?: string, cwd?: string): ProfilesCommandResult;

package/dist/commands/profiles-command.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.profilesCommand = profilesCommand;
-const project_context_1 = require("../app/project-context");
-function profilesCommand(rootArg, cwd = process.cwd()) {
-    const project = (0, project_context_1.loadProjectContext)(rootArg, cwd);
-    const warnings = [...project.warnings];
-    const errors = [...project.errors];
-    if (errors.length)
-        return { profiles: [], warnings, errors };
-    return {
-        profiles: Object.keys(project.config.profiles ?? {}).sort(),
-        warnings,
-        errors,
-    };
-}

package/dist/commands/run-command.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runCommand = runCommand;
-const execute_run_1 = require("../app/execute-run");
-const run_plans_1 = require("../app/run-plans");
-async function runCommand(params) {
-    const planned = (0, run_plans_1.createRunPlans)(params);
-    const warnings = [...planned.warnings];
-    const errors = [...planned.errors];
-    if (errors.length)
-        return { runs: [], warnings, errors };
-    const runs = [];
-    for (const plan of planned.plans) {
-        runs.push(await (0, execute_run_1.executeRun)(plan));
-    }
-    return { runs, warnings, errors };
-}

package/dist/config/build-config.d.ts

@@ -1,13 +0,0 @@
-import type { DeepPartial, ProdexConfig, ProdexConfigFile, ProdexFlags } from "../types";
-export interface ConfigBuildResult {
-    config?: ProdexConfig;
-    warnings: string[];
-    errors: string[];
-}
-export declare function buildConfig(params: {
-    root: string;
-    userConfig: ProdexConfigFile;
-    flags?: Partial<ProdexFlags>;
-    profileName?: string;
-}): ConfigBuildResult;
-export declare function deepMerge<T extends Record<string, any>>(base: T, patch: DeepPartial<T>): T;

package/dist/config/build-config.js

@@ -1,127 +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.buildConfig = buildConfig;
-exports.deepMerge = deepMerge;
-const path_1 = __importDefault(require("path"));
-const default_config_1 = require("./default-config");
-const path_2 = require("../filesystem/path");
-const string_list_1 = require("./string-list");
-function buildConfig(params) {
-    const warnings = [];
-    const errors = [];
-    const base = deepMerge(default_config_1.DEFAULT_PRODEX_CONFIG, params.userConfig || {});
-    const profile = params.profileName ? base.profiles?.[params.profileName] : undefined;
-    if (params.profileName && !profile) {
-        errors.push(`Unknown profile "${params.profileName}".`);
-        return { warnings, errors };
-    }
-    const layered = applyProfileLayer(base, profile);
-    const config = toRuntimeConfig(layered, params.root, params.flags, profile, params.profileName);
-    normalizeRuntimeConfig(config, warnings);
-    validateRuntimeConfig(config, errors);
-    return { config, warnings, errors };
-}
-function applyProfileLayer(config, profile) {
-    if (!profile)
-        return config;
-    const patch = {};
-    if (profile.entry)
-        patch.entry = profile.entry;
-    if (profile.include)
-        patch.include = profile.include;
-    if (profile.exclude)
-        patch.exclude = profile.exclude;
-    return deepMerge(config, patch);
-}
-function toRuntimeConfig(fileConfig, root, flags, profile, profileName) {
-    const output = {
-        ...default_config_1.DEFAULT_PRODEX_CONFIG.output,
-        ...fileConfig.output,
-    };
-    const resolve = {
-        ...default_config_1.DEFAULT_PRODEX_CONFIG.resolve,
-        ...fileConfig.resolve,
-    };
-    const cfg = {
-        ...fileConfig,
-        output,
-        resolve,
-        entry: fileConfig.entry ?? [],
-        include: fileConfig.include ?? [],
-        exclude: fileConfig.exclude ?? [],
-        profiles: fileConfig.profiles ?? {},
-        root,
-        name: flags?.name ?? profile?.name ?? profileName,
-    };
-    applyExplicitFlags(cfg, flags);
-    return cfg;
-}
-function applyExplicitFlags(cfg, flags) {
-    if (!flags)
-        return;
-    if (flags.format !== undefined)
-        cfg.output.format = flags.format;
-    if (flags.name !== undefined && flags.name !== null)
-        cfg.name = (0, path_2.sanitizeFileName)(flags.name);
-    if (flags.maxDepth !== undefined && flags.maxDepth !== null)
-        cfg.resolve.maxDepth = flags.maxDepth;
-    if (flags.maxFiles !== undefined && flags.maxFiles !== null)
-        cfg.resolve.maxFiles = flags.maxFiles;
-    if (flags.entry !== undefined)
-        cfg.entry = flags.entry;
-    if (flags.include !== undefined)
-        cfg.include = flags.include;
-    if (flags.exclude !== undefined)
-        cfg.exclude = flags.exclude;
-}
-function normalizeRuntimeConfig(cfg, warnings) {
-    cfg.root = path_1.default.resolve(cfg.root);
-    cfg.output.dir = (0, path_2.normalizePath)(String(cfg.output.dir || "prodex"));
-    cfg.name = cfg.name ? (0, path_2.sanitizeFileName)(String(cfg.name)) : undefined;
-    cfg.entry = normalizePatterns(cfg.entry, warnings, "entry");
-    cfg.include = normalizePatterns(cfg.include, warnings, "include");
-    cfg.exclude = normalizePatterns(cfg.exclude, warnings, "exclude");
-    cfg.resolve.aliases = cfg.resolve.aliases ?? {};
-    cfg.profiles = cfg.profiles ?? {};
-}
-function normalizePatterns(value, warnings, field) {
-    const normalized = [];
-    for (const item of (0, string_list_1.toStringList)(value))
-        normalized.push((0, path_2.normalizePath)(item));
-    if (!Array.isArray(value) && value !== undefined && typeof value !== "string") {
-        warnings.push(`${field} should be a string array; ignoring invalid value.`);
-    }
-    return normalized;
-}
-function validateRuntimeConfig(cfg, errors) {
-    if (!["md", "txt"].includes(cfg.output.format)) {
-        errors.push(`output.format must be "md" or "txt".`);
-    }
-    if (!Number.isFinite(cfg.resolve.maxDepth) || cfg.resolve.maxDepth < 0) {
-        errors.push("resolve.maxDepth must be a non-negative number.");
-    }
-    if (!Number.isFinite(cfg.resolve.maxFiles) || cfg.resolve.maxFiles < 0) {
-        errors.push("resolve.maxFiles must be a non-negative number.");
-    }
-}
-function deepMerge(base, patch) {
-    const out = Array.isArray(base) ? [...base] : { ...base };
-    for (const [key, value] of Object.entries(patch || {})) {
-        if (value === undefined)
-            continue;
-        const current = base[key];
-        if (Array.isArray(value))
-            out[key] = [...value];
-        else if (isPlainObject(value) && isPlainObject(current))
-            out[key] = deepMerge(current, value);
-        else
-            out[key] = value;
-    }
-    return out;
-}
-function isPlainObject(value) {
-    return !!value && typeof value === "object" && !Array.isArray(value);
-}

package/dist/tracing/include-files.d.ts

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

package/dist/tracing/include-files.js

@@ -1,36 +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.applyIncludes = applyIncludes;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const glob_scan_1 = require("../filesystem/glob-scan");
-const path_2 = require("../filesystem/path");
-const trace_stats_1 = require("./trace-stats");
-async function applyIncludes(cfg, files) {
-    const { include, root } = cfg;
-    const absoluteFiles = [];
-    const patterns = [];
-    for (const raw of include) {
-        const candidate = String(raw ?? "").trim();
-        if (!candidate)
-            continue;
-        const normalized = (0, path_2.normalizePath)(candidate);
-        if (path_1.default.isAbsolute(normalized)) {
-            try {
-                if (fs_1.default.statSync(normalized).isFile()) {
-                    absoluteFiles.push(path_1.default.resolve(normalized));
-                    continue;
-                }
-            }
-            catch {
-                // Treat unreadable absolute paths as glob patterns so include handling stays consistent.
-            }
-        }
-        patterns.push(normalized);
-    }
-    const scan = await (0, glob_scan_1.globScan)(patterns, { cwd: root });
-    return (0, trace_stats_1.unique)([...files, ...absoluteFiles, ...scan.files]);
-}

package/dist/tracing/trace-run.d.ts

@@ -1,2 +0,0 @@
-import type { TraceParams, TraceResult } from "../types";
-export declare function runTrace({ cfg, opts }: TraceParams): Promise<TraceResult>;

package/dist/tracing/trace-run.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runTrace = runTrace;
-const follow_chain_1 = require("./follow-chain");
-const include_files_1 = require("./include-files");
-const naming_1 = require("../output/naming");
-const produce_output_1 = require("../output/produce-output");
-async function runTrace({ cfg, opts }) {
-    const entries = opts.entries ?? [];
-    const result = entries.length ? await (0, follow_chain_1.followChain)(entries, cfg) : undefined;
-    const files = await (0, include_files_1.applyIncludes)(cfg, result?.files ?? []);
-    if (!files.length) {
-        return { entries, files: [], stats: result?.stats };
-    }
-    const outputPath = await (0, produce_output_1.produceOutput)({
-        name: opts.outputName ?? (0, naming_1.smartNaming)(entries),
-        files,
-        cfg,
-    });
-    return { outputPath, entries, files, stats: result?.stats };
-}