@vizzly-testing/cli 0.26.1 → 0.27.0

package/dist/utils/output.js

@@ -28,6 +28,8 @@ const VALID_LOG_LEVELS = Object.keys(LOG_LEVELS);
 // Module state
 const config = {
   json: false,
+  jsonFields: null,
+  // null = all fields, array = selected fields
   logLevel: null,
   // null = not yet initialized, will check env var on first configure
   color: undefined,
@@ -74,12 +76,96 @@ function normalizeLogLevel(level) {
   return VALID_LOG_LEVELS.includes(normalized) ? normalized : 'info';
 }
 
+/**
+ * Parse --json flag value into field list
+ * Supports: true (all fields), "field1,field2" (selected fields)
+ * @param {boolean|string} jsonArg - The --json flag value
+ * @returns {string[]|null} Array of field names, or null for all fields
+ */
+export function parseJsonFields(jsonArg) {
+  if (jsonArg === true || jsonArg === 'true') return null; // All fields
+  if (typeof jsonArg === 'string' && jsonArg.length > 0) {
+    return jsonArg.split(',').map(f => f.trim()).filter(f => f.length > 0);
+  }
+  return null;
+}
+
+/**
+ * Get a nested value from an object using dot notation
+ * @param {Object} obj - Source object
+ * @param {string} path - Dot-separated path (e.g., "comparisons.total")
+ * @returns {*} The value at the path, or undefined if not found
+ */
+function getNestedValue(obj, path) {
+  let parts = path.split('.');
+  let current = obj;
+  for (let part of parts) {
+    if (current === null || current === undefined) return undefined;
+    current = current[part];
+  }
+  return current;
+}
+
+/**
+ * Set a nested value in an object using dot notation
+ * Creates intermediate objects as needed
+ * @param {Object} obj - Target object
+ * @param {string} path - Dot-separated path (e.g., "comparisons.total")
+ * @param {*} value - Value to set
+ */
+function setNestedValue(obj, path, value) {
+  let parts = path.split('.');
+  let current = obj;
+  for (let i = 0; i < parts.length - 1; i++) {
+    let part = parts[i];
+    if (!(part in current)) {
+      current[part] = {};
+    }
+    current = current[part];
+  }
+  current[parts[parts.length - 1]] = value;
+}
+
+/**
+ * Select specific fields from an object
+ * Supports dot notation for nested fields (e.g., "comparisons.total")
+ * Warns in debug mode when requested fields aren't found
+ * @param {Object|Array} obj - Source object or array
+ * @param {string[]} fields - Fields to select
+ * @returns {Object|Array} Object with only selected fields
+ */
+function selectFields(obj, fields) {
+  if (Array.isArray(obj)) {
+    return obj.map(item => selectFields(item, fields));
+  }
+  if (obj === null || typeof obj !== 'object') {
+    return obj;
+  }
+  let result = {};
+  let missingFields = [];
+  for (let field of fields) {
+    let value = getNestedValue(obj, field);
+    if (value !== undefined) {
+      setNestedValue(result, field, value);
+    } else {
+      missingFields.push(field);
+    }
+  }
+
+  // Warn about missing fields in verbose mode
+  if (missingFields.length > 0 && shouldLog('debug')) {
+    console.error(colors.dim(`Note: Requested field(s) not found: ${missingFields.join(', ')}`));
+  }
+  return result;
+}
+
 /**
  * Configure output settings
  * Call this once at CLI startup with global options
  *
  * @param {Object} options - Configuration options
- * @param {boolean} [options.json] - Enable JSON output mode
+ * @param {boolean|string} [options.json] - Enable JSON output mode, optionally with field selection
+ * @param {string[]} [options.jsonFields] - Fields to include in JSON output (null = all)
  * @param {string} [options.logLevel] - Log level (debug, info, warn, error)
  * @param {boolean} [options.verbose] - Shorthand for logLevel='debug' (backwards compatible)
  * @param {boolean} [options.color] - Enable colored output
@@ -88,7 +174,12 @@ function normalizeLogLevel(level) {
  * @param {boolean} [options.resetTimer] - Reset the start timer (default: true)
  */
 export function configure(options = {}) {
-  if (options.json !== undefined) config.json = options.json;
+  // Handle --json flag: can be boolean or string of fields
+  if (options.json !== undefined) {
+    config.json = !!options.json; // Truthy check for JSON mode
+    config.jsonFields = parseJsonFields(options.json);
+  }
+  if (options.jsonFields !== undefined) config.jsonFields = options.jsonFields;
   if (options.color !== undefined) config.color = options.color;
   if (options.silent !== undefined) config.silent = options.silent;
   if (options.logFile !== undefined) config.logFile = options.logFile;
@@ -336,18 +427,29 @@ export function printErr(text) {
 
 /**
  * Output structured data
+ * When field selection is active, only specified fields are included
+ * @param {Object|Array} obj - Data to output
  */
 export function data(obj) {
+  let output = config.jsonFields ? selectFields(obj, config.jsonFields) : obj;
   if (config.json) {
     console.log(JSON.stringify({
       status: 'data',
-      data: obj
+      data: output
     }));
   } else {
-    console.log(JSON.stringify(obj, null, 2));
+    console.log(JSON.stringify(output, null, 2));
   }
 }
 
+/**
+ * Get configured JSON fields (for commands that need direct access)
+ * @returns {string[]|null} Array of field names, or null for all fields
+ */
+export function getJsonFields() {
+  return config.jsonFields;
+}
+
 // ============================================================================
 // Spinner / Progress (stderr so it doesn't pollute piped output)
 // ============================================================================
@@ -982,6 +1084,7 @@ export function cleanup() {
 export function reset() {
   stopSpinner();
   config.json = false;
+  config.jsonFields = null;
   config.logLevel = null;
   config.color = undefined; // Reset to auto-detect
   config.silent = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizzly-testing/cli",
-  "version": "0.26.1",
+  "version": "0.27.0",
   "description": "Visual review platform for UI developers and designers",
   "keywords": [
     "visual-testing",
@@ -56,6 +56,7 @@
     "LICENSE"
   ],
   "scripts": {
+    "cli": "source .envrc && node bin/vizzly.js",
     "start": "node src/index.js",
     "build": "npm run clean && npm run compile && npm run build:reporter && npm run build:reporter-ssr && npm run copy-types",
     "clean": "rimraf dist",