@mediaproc/core 1.2.0 → 1.2.2

package/README.md

@@ -40,7 +40,7 @@ showBranding();
 // ────────────────────────────────────────────────────────────
 
 // Show plugin branding (automatically detects version)
-showPluginBranding("Image");
+showPluginBranding("Image", "path/to/package.json");
 // Output:
 // ────────────────────────────────────────────────────────────
 //   💎 Image Plugin v1.3.3 · Powered by MediaProc

package/dist/branding/branding.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Get version from package.json
+ */
+export declare function getVersion(packagePath: string): string;
+/**
+ * Get CLI version from root package.json
+ */
+export declare function getCliVersion(): string;
 /**
  * Show CLI branding footer with documentation and GitHub links
  */

package/dist/branding/branding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/branding/branding.ts"],"names":[],"mappings":"AAmCA;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAOnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAO/E"}
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/branding/branding.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CActC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAOnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAO/E"}

package/dist/branding/branding.js

@@ -4,7 +4,7 @@ import { fileURLToPath } from 'url';
 /**
  * Get version from package.json
  */
-function getVersion(packagePath) {
+export function getVersion(packagePath) {
     try {
         const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
         return packageJson.version || '0.0.0';
@@ -16,7 +16,7 @@ function getVersion(packagePath) {
 /**
  * Get CLI version from root package.json
  */
-function getCliVersion() {
+export function getCliVersion() {
     try {
         // For ES modules, use import.meta.url
         if (typeof import.meta.url !== 'undefined') {

package/dist/branding/branding.js.map

@@ -1 +1 @@
-{"version":3,"file":"branding.js","sourceRoot":"","sources":["../../src/branding/branding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,SAAS,UAAU,CAAC,WAAmB;IACrC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,OAAO,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,sCAAsC;QACtC,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;YAC3D,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,mCAAmC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACxD,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,CAAC,mBAAmB;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,UAAkB;IACvE,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,QAAQ,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,OAAO,yBAAyB,CAAC,CAAC;IAC1H,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"branding.js","sourceRoot":"","sources":["../../src/branding/branding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,OAAO,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,sCAAsC;QACtC,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;YAC3D,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,mCAAmC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACxD,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,CAAC,mBAAmB;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,UAAkB;IACvE,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,QAAQ,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,OAAO,yBAAyB,CAAC,CAAC;IAC1H,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/explainFlag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainFlag.d.ts","sourceRoot":"","sources":["../src/explainFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGnF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,IAAS,EACT,OAAY,EACZ,SAAkC,EAClC,UAA0C,EAC1C,MAAgB,GACjB,EAAE;IACD,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,QA8CA"}
+{"version":3,"file":"explainFlag.d.ts","sourceRoot":"","sources":["../src/explainFlag.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAMnF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,IAAS,EACT,OAAY,EACZ,SAAkC,EAClC,UAA0C,EAC1C,MAAgB,GACjB,EAAE;IACD,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,QAkIA"}

package/dist/explainFlag.js

@@ -1,4 +1,7 @@
+import chalk from 'chalk';
 import { explainFormatter } from './formatters/explainFormatter.js';
+import { getCliVersion, getVersion } from './branding/branding.js';
+import os from 'os';
 /**
  * explainFlag - Automatically gathers command context, prints explanation, then runs the handler.
  * @param params - { commandName, args, options, handler }
@@ -6,6 +9,12 @@ import { explainFormatter } from './formatters/explainFormatter.js';
 export function explainFlag({ command, args = {}, options = {}, inputKeys = ['input', 'inputPath'], outputKeys = ['output', 'outputPath', 'o'], format = 'human', }) {
     // Auto-detect command name
     const commandName = command?.name?.() || command?._name || 'unknown';
+    const environment = {
+        cwd: process.cwd(),
+        os: `${os.type()} ${os.release()} (${os.platform()})`,
+        nodeVersion: process.version,
+        shell: process.env.SHELL || process.env.TERM || 'unknown',
+    };
     // Detect input/output paths
     let inputPath = '';
     let outputPath = '';
@@ -22,31 +31,115 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
             outputPath = options[k];
     }
     // Gather used flags
+    let explainValue = undefined;
+    if (typeof options.explain === 'string') {
+        explainValue = options.explain;
+    }
+    else if (Array.isArray(args._) && args._.length > 0) {
+        // Check for --explain details as positional
+        const idx = args._.findIndex((v) => v === 'explain');
+        if (idx !== -1 && args._[idx + 1]) {
+            explainValue = args._[idx + 1];
+        }
+    }
+    if (explainValue === 'details' || explainValue === 'json' || explainValue === 'human') {
+        format = explainValue;
+    }
+    // Gather all possible flags from command (Commander.js API)
     const usedFlags = {};
-    for (const [key, value] of Object.entries(options)) {
-        if (key === 'explain')
-            continue;
-        usedFlags[key] = { value, source: value !== undefined ? 'user' : 'system' };
+    const omittedFlags = {};
+    if (command && typeof command.options === 'object') {
+        for (const opt of command.options) {
+            const flagName = opt.attributeName || opt.long?.replace(/^--/, '') || opt.short?.replace(/^-/, '');
+            if (!flagName)
+                continue;
+            const userValue = options[flagName];
+            if (userValue !== undefined) {
+                usedFlags[flagName] = { value: userValue, source: 'user' };
+            }
+            else if (Object.prototype.hasOwnProperty.call(opt, 'defaultValue')) {
+                usedFlags[flagName] = { value: opt.defaultValue, source: 'default' };
+                omittedFlags[flagName] = { defaultValue: opt.defaultValue, source: 'default' };
+            }
+            else {
+                usedFlags[flagName] = { value: undefined, source: 'system' };
+            }
+        }
+    }
+    else {
+        for (const [key, value] of Object.entries(options)) {
+            if (key === 'explain')
+                continue;
+            usedFlags[key] = { value, source: value !== undefined ? 'user' : 'system' };
+        }
+    }
+    // Build ExplainContext with plugin/command info and version
+    // Get CLI and plugin version using branding utilities
+    let cliVersion = undefined;
+    let pluginVersion = undefined;
+    try {
+        cliVersion = getCliVersion();
+        // Try to get plugin version from parent command's package.json if available
+        if (command?.parent?.name?.()) {
+            // Assume plugin package.json is at ../../plugins/<plugin>/package.json
+            const pluginName = command.parent.name();
+            const pluginPath = `../../plugins/${pluginName}/package.json`;
+            pluginVersion = getVersion(pluginPath);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('Error retrieving version information:'), error);
     }
-    // Build ExplainContext
     const context = {
         command: commandName,
+        plugin: command?.parent?.name?.() || undefined,
+        cliVersion,
+        pluginVersion,
         inputs: { inputPath, outputPath },
         usedFlags,
+        omittedFlags: Object.keys(omittedFlags).length > 0 ? omittedFlags : undefined,
         decisions: Object.entries(usedFlags).map(([key, v]) => ({
             key,
             value: v.value,
-            reason: v.source === 'user' ? 'user specified' : 'default',
+            reason: v.source === 'user' ? 'user specified' : (v.source === 'default' ? 'default' : 'system'),
         })),
         outcome: {
             result: outputPath ? `A new file will be created at ${outputPath}` : 'Operation will complete',
-            sideEffects: [],
+            sideEffects: [
+                'Input validation is performed to ensure correct file types and dimensions.',
+                'Output paths are resolved and checked for conflicts.',
+                'Image processing is performed using the selected options and flags.',
+                'Results and logs are displayed after processing each file.'
+            ],
+            errors: [], // Placeholder for error reporting
+            warnings: [], // Placeholder for warning reporting
+        },
+        explainFlow: [
+            '1. Parse and validate all user-provided flags and arguments.',
+            '2. Check input and output paths for validity and existence.',
+            '3. Prepare configuration for image processing (width, height, quality, etc.).',
+            '4. For each input file, process and apply transformations.',
+            '5. Save output files and display results.',
+            '6. Show summary and any errors encountered.'
+        ],
+        environment,
+        technical: {
+            library: 'sharp',
+            tool: 'mediaproc',
+            performance: 'optimized for batch image processing',
+            fileFormats: ['jpg', 'png', 'webp'],
+            compressionRatio: 'varies by format and quality',
+            estimatedTime: 'depends on input size and options',
+            memoryUsage: 'depends on batch size and image dimensions',
         },
     };
     // Print explanation only
     const explanation = explainFormatter(context, format);
     if (format === 'json') {
-        console.log(JSON.stringify(explanation, null, 2));
+        // Add a styled header for JSON output
+        // Print JSON with a clear header
+        console.log(chalk.bold.bgBlueBright.white(' EXPLANATION (JSON) '));
+        console.log(chalk.gray(JSON.stringify(explanation, null, 2)));
     }
     else {
         console.log(explanation);

package/dist/explainFlag.js.map

@@ -1 +1 @@
-{"version":3,"file":"explainFlag.js","sourceRoot":"","sources":["../src/explainFlag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAiB,MAAM,kCAAkC,CAAC;AAGnF;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,OAAO,EACP,IAAI,GAAG,EAAE,EACT,OAAO,GAAG,EAAE,EACZ,SAAS,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,EAClC,UAAU,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,CAAC,EAC1C,MAAM,GAAG,OAAO,GAQjB;IACC,2BAA2B;IAC3B,MAAM,WAAW,GAAG,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,OAAO,EAAE,KAAK,IAAI,SAAS,CAAC;IAErE,4BAA4B;IAC5B,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,CAAC,CAAC;YAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,CAAC,CAAC;YAAE,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,OAAO,CAAC,CAAC,CAAC;YAAE,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,oBAAoB;IACpB,MAAM,SAAS,GAA8D,EAAE,CAAC;IAChF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9E,CAAC;IAED,uBAAuB;IACvB,MAAM,OAAO,GAAmB;QAC9B,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;QACjC,SAAS;QACT,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtD,GAAG;YACH,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;SAC3D,CAAC,CAAC;QACH,OAAO,EAAE;YACP,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,iCAAiC,UAAU,EAAE,CAAC,CAAC,CAAC,yBAAyB;YAC9F,WAAW,EAAE,EAAE;SAChB;KACF,CAAC;IAEF,yBAAyB;IACzB,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}
+{"version":3,"file":"explainFlag.js","sourceRoot":"","sources":["../src/explainFlag.ts"],"names":[],"mappings":"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"}

package/dist/formatters/explainFormatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainFormatter.d.ts","sourceRoot":"","sources":["../../src/formatters/explainFormatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,cAAc,EACvB,MAAM,GAAE,aAAuB,EAC/B,KAAK,GAAE,MAAM,GAAG,OAAO,GAAG,KAAc,GACtC,MAAM,GAAG,MAAM,CAgDjB"}
+{"version":3,"file":"explainFormatter.d.ts","sourceRoot":"","sources":["../../src/formatters/explainFormatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,cAAc,EACvB,MAAM,GAAE,aAAuB,EAC/B,KAAK,GAAE,MAAM,GAAG,OAAO,GAAG,KAAc,GACtC,MAAM,GAAG,MAAM,CAwMjB"}

package/dist/formatters/explainFormatter.js

@@ -1,3 +1,4 @@
+import chalk from 'chalk';
 /**
  * Main explain formatter. Returns a string (or JSON) for the given context and format.
  */
@@ -12,38 +13,200 @@ export function explainFormatter(context, format = 'human', tense = 'will') {
         would: { what: 'would', result: 'would be', why: 'Why' },
         did: { what: 'was', result: 'was', why: 'Why' },
     }[tense];
-    // Human-first (default)
     let output = '';
-    output += `What ${tenseMap.what} happen:\n`;
-    for (const d of context.decisions) {
-        output += `• ${decisionToHuman(d)}\n`;
-    }
-    if (context.outcome && context.outcome.result) {
-        output += `\nResult:\n• ${context.outcome.result}\n`;
-        if (context.outcome.sideEffects && context.outcome.sideEffects.length > 0) {
-            for (const s of context.outcome.sideEffects) {
-                output += `• ${s}\n`;
+    if (format === 'human') {
+        output += chalk.bold.bgBlueBright.white('╔════════════════════════════════════════════════════════════════╗') + '\n';
+        output += chalk.bold.bgBlueBright.white('║                        EXPLANATION                           ║') + '\n';
+        output += chalk.bold.bgBlueBright.white('╚════════════════════════════════════════════════════════════════╝') + '\n';
+        if (context.plugin || context.cliVersion || context.pluginVersion) {
+            output += chalk.bold(`Plugin: ${context.plugin || 'N/A'} | CLI Version: ${context.cliVersion || 'N/A'} | Plugin Version: ${context.pluginVersion || 'N/A'}`) + '\n';
+        }
+        output += chalk.bold.underline(`\n${chalk.cyan('What ' + tenseMap.what + ' happen:')}`) + '\n';
+        for (const d of context.decisions) {
+            let valueStr = (d.value === undefined || Number.isNaN(d.value)) ? 'N/A' : d.value;
+            output += chalk.green(`• ${decisionToHuman({ ...d, value: valueStr })}`);
+            if (d.provenance)
+                output += chalk.gray(` [${d.provenance}]`);
+            if (d.omitted)
+                output += chalk.gray(' (omitted)');
+            output += '\n';
+        }
+        if (context.outcome && context.outcome.result) {
+            output += chalk.bold.underline(`\n${chalk.cyan('Result:')}`) + '\n';
+            output += chalk.yellow(`• ${context.outcome.result}`) + '\n';
+            if (context.outcome.sideEffects && context.outcome.sideEffects.length > 0) {
+                for (const s of context.outcome.sideEffects) {
+                    output += chalk.yellow(`• ${s}`) + '\n';
+                }
+            }
+            // Error/warning reporting
+            if (context.outcome.errors && context.outcome.errors.length > 0) {
+                output += chalk.redBright.bold(`\nErrors:`) + '\n';
+                for (const err of context.outcome.errors) {
+                    output += chalk.redBright(`• ${err}`) + '\n';
+                }
+            }
+            if (context.outcome.warnings && context.outcome.warnings.length > 0) {
+                output += chalk.yellowBright.bold(`\nWarnings:`) + '\n';
+                for (const warn of context.outcome.warnings) {
+                    output += chalk.yellowBright(`• ${warn}`) + '\n';
+                }
+            }
+        }
+        output += chalk.bold.underline(`\n${chalk.cyan(tenseMap.why + ':')}`) + '\n';
+        for (const d of context.decisions) {
+            let valueStr = (d.value === undefined || Number.isNaN(d.value)) ? 'N/A' : d.value;
+            output += chalk.magenta(`• ${decisionToWhy({ ...d, value: valueStr })}`);
+            if (d.provenance)
+                output += chalk.gray(` [${d.provenance}]`);
+            if (d.omitted)
+                output += chalk.gray(' (omitted)');
+            output += '\n';
+        }
+        // Show omitted flags
+        if (context.omittedFlags && Object.keys(context.omittedFlags).length > 0) {
+            output += chalk.bold.underline(`\n${chalk.cyan('Omitted Flags:')}`) + '\n';
+            for (const [k, v] of Object.entries(context.omittedFlags)) {
+                output += chalk.gray(`• ${k}: ${v.defaultValue} (${v.source})`) + '\n';
+            }
+        }
+        // Show deprecated flags
+        if (context.deprecatedFlags && context.deprecatedFlags.length > 0) {
+            output += chalk.bold.underline(`\n${chalk.cyan('Deprecated Flags:')}`) + '\n';
+            for (const k of context.deprecatedFlags) {
+                output += chalk.redBright(`• ${k}`) + '\n';
+            }
+        }
+        // Show ignored flags
+        if (context.ignoredFlags && context.ignoredFlags.length > 0) {
+            output += chalk.bold.underline(`\n${chalk.cyan('Ignored Flags:')}`) + '\n';
+            for (const k of context.ignoredFlags) {
+                output += chalk.gray(`• ${k}`) + '\n';
+            }
+        }
+        // Show custom sections for plugin extensibility
+        if (context.customSections && context.customSections.length > 0) {
+            for (const section of context.customSections) {
+                output += chalk.bold.underline(`\n${chalk.cyan(section.title)}`) + '\n';
+                for (const item of section.items) {
+                    output += chalk.whiteBright(`• ${item}`) + '\n';
+                }
+            }
+        }
+        // Technical details
+        if (context.technical) {
+            output += chalk.bold.underline(`\n${chalk.cyan('Technical details:')}`) + '\n';
+            for (const [k, v] of Object.entries(context.technical)) {
+                let valueStr = (v === undefined || Number.isNaN(v)) ? 'N/A' : v;
+                output += chalk.gray(`• ${k}: ${valueStr}`) + '\n';
             }
         }
     }
-    output += `\n${tenseMap.why}:\n`;
-    for (const d of context.decisions) {
-        output += `• ${decisionToWhy(d)}\n`;
-    }
-    if (format === 'details') {
-        // Add technical details if present
+    else if (format === 'details') {
+        output += chalk.bold.bgMagenta.white('╔════════════════════════════════════════════════════════════════╗') + '\n';
+        output += chalk.bold.bgMagenta.white('║                  EXPLANATION (DETAILS)                       ║') + '\n';
+        output += chalk.bold.bgMagenta.white('╚════════════════════════════════════════════════════════════════╝') + '\n';
+        if (context.plugin || context.cliVersion || context.pluginVersion) {
+            output += chalk.bold(`Plugin: ${context.plugin || 'N/A'} | CLI Version: ${context.cliVersion || 'N/A'} | Plugin Version: ${context.pluginVersion || 'N/A'}`) + '\n';
+        }
+        output += chalk.bold.underline(`\n${chalk.cyan('What ' + tenseMap.what + ' happen:')}`) + '\n';
+        for (const d of context.decisions) {
+            let valueStr = (d.value === undefined || Number.isNaN(d.value)) ? 'N/A' : d.value;
+            output += chalk.greenBright(`• ${decisionToHuman({ ...d, value: valueStr })}`);
+            if (d.provenance)
+                output += chalk.gray(` [${d.provenance}]`);
+            if (d.omitted)
+                output += chalk.gray(' (omitted)');
+            output += '\n';
+        }
+        if (context.outcome && context.outcome.result) {
+            output += chalk.bold.underline(`\n${chalk.cyan('Result:')}`) + '\n';
+            output += chalk.yellowBright(`• ${context.outcome.result}`) + '\n';
+            if (context.outcome.sideEffects && context.outcome.sideEffects.length > 0) {
+                for (const s of context.outcome.sideEffects) {
+                    output += chalk.yellowBright(`• ${s}`) + '\n';
+                }
+            }
+            // Error/warning reporting
+            if (context.outcome.errors && context.outcome.errors.length > 0) {
+                output += chalk.redBright.bold(`\nErrors:`) + '\n';
+                for (const err of context.outcome.errors) {
+                    output += chalk.redBright(`• ${err}`) + '\n';
+                }
+            }
+            if (context.outcome.warnings && context.outcome.warnings.length > 0) {
+                output += chalk.yellowBright.bold(`\nWarnings:`) + '\n';
+                for (const warn of context.outcome.warnings) {
+                    output += chalk.yellowBright(`• ${warn}`) + '\n';
+                }
+            }
+        }
+        output += chalk.bold.underline(`\n${chalk.cyan(tenseMap.why + ':')}`) + '\n';
+        for (const d of context.decisions) {
+            let valueStr = (d.value === undefined || Number.isNaN(d.value)) ? 'N/A' : d.value;
+            output += chalk.magentaBright(`• ${decisionToWhy({ ...d, value: valueStr })}`);
+            if (d.provenance)
+                output += chalk.gray(` [${d.provenance}]`);
+            if (d.omitted)
+                output += chalk.gray(' (omitted)');
+            output += '\n';
+        }
+        // Show omitted flags
+        if (context.omittedFlags && Object.keys(context.omittedFlags).length > 0) {
+            output += chalk.bold.underline(`\n${chalk.cyan('Omitted Flags:')}`) + '\n';
+            for (const [k, v] of Object.entries(context.omittedFlags)) {
+                output += chalk.gray(`• ${k}: ${v.defaultValue} (${v.source})`) + '\n';
+            }
+        }
+        // Show deprecated flags
+        if (context.deprecatedFlags && context.deprecatedFlags.length > 0) {
+            output += chalk.bold.underline(`\n${chalk.cyan('Deprecated Flags:')}`) + '\n';
+            for (const k of context.deprecatedFlags) {
+                output += chalk.redBright(`• ${k}`) + '\n';
+            }
+        }
+        // Show ignored flags
+        if (context.ignoredFlags && context.ignoredFlags.length > 0) {
+            output += chalk.bold.underline(`\n${chalk.cyan('Ignored Flags:')}`) + '\n';
+            for (const k of context.ignoredFlags) {
+                output += chalk.gray(`• ${k}`) + '\n';
+            }
+        }
+        // Show custom sections for plugin extensibility
+        if (context.customSections && context.customSections.length > 0) {
+            for (const section of context.customSections) {
+                output += chalk.bold.underline(`\n${chalk.cyan(section.title)}`) + '\n';
+                for (const item of section.items) {
+                    output += chalk.whiteBright(`• ${item}`) + '\n';
+                }
+            }
+        }
+        // Technical details
+        if (context.technical) {
+            output += chalk.bold.underline(`\n${chalk.cyan('Technical details:')}`) + '\n';
+            for (const [k, v] of Object.entries(context.technical)) {
+                output += chalk.gray(`• ${k}: ${v}`) + '\n';
+            }
+        }
         if (context.inferred) {
-            output += `\nTechnical details:\n`;
             for (const [k, v] of Object.entries(context.inferred)) {
-                output += `• ${k}: ${v}\n`;
+                output += chalk.gray(`• ${k}: ${v}`) + '\n';
             }
         }
         if (context.usedFlags) {
-            output += `\nFlags used:\n`;
+            output += chalk.bold.underline(`\n${chalk.cyan('Flags used:')}`) + '\n';
             for (const [k, v] of Object.entries(context.usedFlags)) {
-                output += `• ${k}: ${v.value} (${v.source})\n`;
+                let valueStr = (v.value === undefined || Number.isNaN(v.value)) ? 'N/A' : v.value;
+                output += chalk.gray(`• ${k}: ${valueStr} (${v.source})`) + '\n';
             }
         }
+        // Add extra info for developers
+        output += chalk.bold.underline(`\n${chalk.cyan('Execution flow:')}`) + '\n';
+        output += chalk.whiteBright('• Input validation, output path resolution, image processing, result summary') + '\n';
+        output += chalk.whiteBright('• All steps are performed in sequence for each input file') + '\n';
+        if (context.environment) {
+            output += chalk.bold(`Environment: cwd=${context.environment.cwd}, OS=${context.environment.os}, Node=${context.environment.nodeVersion}, Shell=${context.environment.shell}`) + '\n';
+        }
     }
     return output.trim();
 }

package/dist/formatters/explainFormatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"explainFormatter.js","sourceRoot":"","sources":["../../src/formatters/explainFormatter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"explainFormatter.js","sourceRoot":"","sources":["../../src/formatters/explainFormatter.ts"],"names":[],"mappings":"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"}

package/dist/types/explainTypes.d.ts

@@ -1,27 +1,66 @@
-export type ExplainFlagSource = 'user' | 'system';
+export type ExplainFlagSource = 'user' | 'system' | 'default' | 'deprecated' | 'ignored';
 export interface ExplainDecision {
     key: string;
     value: any;
     reason: string;
+    provenance?: ExplainFlagSource;
+    omitted?: boolean;
 }
 export interface ExplainContext {
     command: string;
+    plugin?: string;
+    commandGroup?: string;
+    cliVersion?: string;
+    pluginVersion?: string;
     inputs: {
         [key: string]: any;
     };
+    outputs?: {
+        [key: string]: any;
+    };
     usedFlags: {
         [flag: string]: {
             value: any;
             source: ExplainFlagSource;
         };
     };
+    omittedFlags?: {
+        [flag: string]: {
+            defaultValue: any;
+            source: ExplainFlagSource;
+        };
+    };
     inferred?: {
         [key: string]: any;
     };
+    deprecatedFlags?: string[];
+    ignoredFlags?: string[];
     decisions: ExplainDecision[];
     outcome: {
         result: string;
         sideEffects?: string[];
+        errors?: string[];
+        warnings?: string[];
+    };
+    explainFlow?: string[];
+    environment?: {
+        cwd?: string;
+        os?: string;
+        nodeVersion?: string;
+        shell?: string;
+    };
+    technical?: {
+        library?: string;
+        tool?: string;
+        performance?: string;
+        fileFormats?: string[];
+        compressionRatio?: string;
+        estimatedTime?: string;
+        memoryUsage?: string;
     };
+    customSections?: Array<{
+        title: string;
+        items: string[];
+    }>;
 }
 //# sourceMappingURL=explainTypes.d.ts.map

package/dist/types/explainTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainTypes.d.ts","sourceRoot":"","sources":["../../src/types/explainTypes.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,SAAS,EAAE;QACT,CAAC,IAAI,EAAE,MAAM,GAAG;YAAE,KAAK,EAAE,GAAG,CAAC;YAAC,MAAM,EAAE,iBAAiB,CAAA;SAAE,CAAC;KAC3D,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;CACH"}
+{"version":3,"file":"explainTypes.d.ts","sourceRoot":"","sources":["../../src/types/explainTypes.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;AACzF,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD,MAAM,WAAW,cAAc;IAE7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,MAAM,EAAE;QACN,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IAGF,SAAS,EAAE;QACT,CAAC,IAAI,EAAE,MAAM,GAAG;YAAE,KAAK,EAAE,GAAG,CAAC;YAAC,MAAM,EAAE,iBAAiB,CAAA;SAAE,CAAC;KAC3D,CAAC;IACF,YAAY,CAAC,EAAE;QACb,CAAC,IAAI,EAAE,MAAM,GAAG;YAAE,YAAY,EAAE,GAAG,CAAC;YAAC,MAAM,EAAE,iBAAiB,CAAA;SAAE,CAAC;KAClE,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAGxB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAGvB,WAAW,CAAC,EAAE;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAGF,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAGF,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mediaproc/core",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Core utilities for MediaProc CLI and Plugins",
   "type": "module",
   "main": "./dist/index.js",