yini-cli 1.3.4 → 1.4.0

package/dist/descriptions.js

@@ -1,6 +1,11 @@
 export const descriptions = {
     yini: 'The official terminal / command-line (CLI) for parsing and validating YINI configuration files.',
     'For-command-parse': 'Parse a YINI file (*.yini) and output the result as JSON or JavaScript.',
-    'For-command-validate': 'Validate a YINI file and print a validation report.',
+    'For-command-validate': `Validate one or more YINI files.
+
+<file>       Validate a single file.
+<directory>  Validate all .yini files in the directory.
+
+You can provide multiple files and directories, separated by spaces.`,
     'For-command-info': 'Display extended information about the YINI CLI environment.',
 };

package/dist/globalOptions/helpOption.js

@@ -8,7 +8,7 @@ import { getPackageName, getPackageVersion } from '../utils/yiniCliHelpers.js';
  */
 export const getHelpTextBefore = () => {
     return `${getPackageName()} ${getPackageVersion()}
-YINI CLI (Yet another INI)
+YINI CLI (by the YINI-lang project)
 
 The official terminal / command-line (CLI) for parsing and validating YINI
 configuration files. A config format, inspired by INI, with type-safe values,
@@ -28,7 +28,8 @@ Quick Examples:
   $ yini parse file.yini --json
   $ yini parse file.yini --js
   $ yini parse file.yini -o output.json
-  $ yini validate --strict config.yini
+  $ yini validate config.yini --stats
+  $ yini validate . --strict
 
 For help with a specific command, use -h or --help. For example:
   $ yini validate --help
@@ -40,11 +41,13 @@ Example YINI configuration file (config.yini)
     title = 'My App'
     items = 10
     debug = ON
+    tags  = ['web', 'demo', 'prod']
 
     ^ Server
-    host = 'localhost'
-    port = 8080
+    host   = 'localhost'
+    port   = 8080
     useTLS = OFF
+    limits = { timeout: 30, keepAlive: true }
 
         // Sub-section of Server.
         ^^ Login
@@ -52,10 +55,10 @@ Example YINI configuration file (config.yini)
         password = 'secret'
 ========================================================
 
-More info:
+More information:
   https://github.com/YINI-lang/yini-cli
 
-YINI homepage:
+Homepage:
   https://yini-lang.org
 `;
 };

package/dist/index.js

@@ -2,13 +2,13 @@
 //
 // (!) IMPORTANT: Leave the top shebang as the very first line! (otherwise command will break)
 //
-// index.ts
+// src/index.ts
 import { createRequire } from 'module';
-import { Command } from 'commander';
+import { Command, Option } from 'commander';
 import { enableHelpAll } from './cli/helpAll.js';
 import { printInfo } from './commands/infoCommand.js';
 import { parseFile } from './commands/parseCommand.js';
-import { validateFile, } from './commands/validateCommand.js';
+import { validateTargets, } from './commands/validateCommand.js';
 import { isDebug, isDev } from './config/env.js';
 import { descriptions as descr } from './descriptions.js';
 import { getHelpTextAfter, getHelpTextBefore, } from './globalOptions/helpOption.js';
@@ -43,20 +43,21 @@ const program = new Command()
     .description(descr.yini)
     // Below will replace all auto-registered items (especially the descriptions starting with a capital and ending with a period).
     .version(getPackageVersion(), '-v, --version', 'Display the version number.')
-    .helpOption('-h, --help', 'Display full help for all commands.')
+    .helpOption('-h, --help', 'Display full help for all commands.') // Yes, shows help for ALL commands via the enableHelpAll() function.
     .helpCommand('help <command>', 'Display help for a specific command.');
 program.addHelpText('before', getHelpTextBefore());
 program.addHelpText('after', getHelpTextAfter());
 /**
- * The (main/global) option: "--strict, --quite, --silent"
+ * The (main/global) options: "--strict, --quiet, --silent"
  */
 // Suggestions for future: --verbose, --debug, --no-color, --color, --timing, --stdin
 program
     .option('--strict', 'Enable strict parsing mode.')
+    .option('--lenient', 'Use lenient mode (this is the default).')
     // .option('-f, --force', 'Continue parsing even if errors occur.')
-    .option('-q, --quiet', 'Reduce output (show only errors).')
-    .option('-s, --silent', 'Suppress all output (even errors, exit code only).')
-    .option('--verbose', 'Display extra information.')
+    .option('-q, --quiet', 'Suppress successful per-file output; still show failures and final summary.')
+    .option('-s, --silent', 'Suppress validation output and use exit code only.')
+    .option('--verbose', 'Show extra processing details.')
     .action((options) => {
     debugPrint('Run global options');
     if (isDebug()) {
@@ -88,10 +89,6 @@ const parseCmd = program
     .action((file, options) => {
     const globals = program.opts(); // Global options.
     const mergedOptions = { ...globals, ...options }; // Merge global options with per-command options.
-    if (mergedOptions.js && mergedOptions.compact) {
-        console.error('Error: --js and --compact cannot be combined.');
-        process.exit(1);
-    }
     debugPrint('Run command "parse"');
     debugPrint('isDebug(): ' + isDebug());
     debugPrint('isDev()  : ' + isDev());
@@ -104,33 +101,54 @@ const parseCmd = program
 });
 appendGlobalOptionsTo(parseCmd);
 /**
- * The command: "validate <file>"
+ * The command: "validate <fileOrDirectory...>"
  */
 const validateCmd = program
-    .command('validate <file>')
+    .command('validate <fileOrDirectory...>')
     .description(descr['For-command-validate'])
-    .option('--stats', 'Include a statistics section (e.g., key count, nesting depth, etc.).')
-    // .option(
-    //     '--details',
-    //     'Print detailed validation info (e.g., line locations, error codes, descriptive text, etc.).',
-    // )
-    .action((file, options) => {
-    const globals = program.opts(); // Global options.
-    const mergedOptions = { ...globals, ...options }; // Merge global options with per-command options.
-    debugPrint('Run command "parse"');
+    // ─────────────────────────────
+    // Reporting / behavior
+    // ─────────────────────────────
+    .option('--warnings-as-errors', 'Treat warnings as errors for exit code purposes.')
+    .option('--stats', 'In text mode, stats only shown when file mode validates exactly one file.')
+    .addOption(new Option('--format <type>', 'Output format for validation results: text | json')
+    .choices(['text', 'json'])
+    .default('text'))
+    // Execution controls (nice-to-have)
+    .option('--fail-fast', 'Stop after first file that fails validation.')
+    .option('--max-errors <n>', 'Stop after N total errors (across files).', (v) => {
+    const n = Number.parseInt(v, 10);
+    if (!Number.isFinite(n) || n < 1) {
+        throw new Error('--max-errors must be a positive integer.');
+    }
+    return n;
+})
+    // ─────────────────────────────
+    // Input handling
+    // ─────────────────────────────
+    // Default: recursive (so only expose the negated option)
+    .option('--no-recursive', 'Do not scan subdirectories.')
+    // ─────────────────────────────
+    // Output handling - WAIT WITH THESE
+    // ─────────────────────────────
+    // .option('-o, --output <file>', 'Write validation report to file.')
+    // .option('--overwrite', 'Allow overwriting an existing output file.')
+    // .option('--no-overwrite', 'Prevent overwriting an existing output file.')
+    .action((fileOrDirectories, options) => {
+    const globals = program.opts();
+    const mergedOptions = { ...globals, ...options };
+    debugPrint('Run command "validate"');
     debugPrint('isDebug(): ' + isDebug());
-    debugPrint('isDev()  : ' + isDev());
-    debugPrint(`<file> = ${file}`);
+    debugPrint('isDev(): ' + isDev());
+    // console.log('options:')
+    // console.log(options)
     if (isDebug()) {
         console.log('mergedOptions:');
         console.log(toPrettyJSON(mergedOptions));
     }
-    if (file) {
-        validateFile(file, mergedOptions);
-    }
-    else {
+    if (!fileOrDirectories?.length)
         program.help();
-    }
+    validateTargets(fileOrDirectories, mergedOptions);
 });
 appendGlobalOptionsTo(validateCmd);
 /**
@@ -150,4 +168,6 @@ appendGlobalOptionsTo(infoCmd);
 // NOTE: Converting YINI files to other formats than json and js.
 // Other format should go into a new CLI-command called 'yini-convert' to not let this command grow too large.
 enableHelpAll(program);
-program.parseAsync();
+// program.parseAsync()
+const normalizedArgv = process.argv.map((arg) => arg === '--no-subdirs' ? '--no-recursive' : arg);
+program.parseAsync(normalizedArgv);

package/dist/utils/string.js

@@ -1,3 +1,4 @@
+// src/utils/string.ts
 export const toColRow = (size, label, value) => {
     return `${label.padEnd(size)} ${value}`;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "yini-cli",
-    "version": "1.3.4",
+    "version": "1.4.0",
     "description": "Official YINI CLI for validating, parsing, and converting a human-friendly config format with real structure, nested sections, and predictable strict or lenient parsing.",
     "keywords": [
         "yini",
@@ -72,7 +72,7 @@
         "commander": "^14.0.1",
         "xmlbuilder2": "^4.0.3",
         "yaml": "^2.8.2",
-        "yini-parser": "^1.4.3"
+        "yini-parser": "^1.5.0"
     },
     "devDependencies": {
         "@eslint/js": "^9.31.0",