yini-cli 1.3.4 → 1.5.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()) {
@@ -78,7 +79,7 @@ const parseCmd = program
     .option('--yaml', 'Output as YAML.')
     .option('--xml', 'Output as XML.')
     // File handling options.
-    .option('-o, --output <file>', 'Write output to <file>. By default, an existing file is only overwritten if it is older than the input YINI file.')
+    .option('-o, --output <file>', 'Write output to <file>. By default, an existing output file is only overwritten if it is older than the input YINI file.')
     .option('--overwrite', 'Always overwrite the output file, even if it is newer than the input YINI file.')
     .option('--no-overwrite', 'Fail if the output file already exists.')
     // Behavior options.
@@ -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/docs/CHANGELOG.md

@@ -0,0 +1,130 @@
+# CHANGELOG
+
+## 1.5.0 - 2026 June
+- Bumped dependency `yini-parser` to `^1.6.0` with YINI Specification RC 6 parser support, which brings:
+  - Improved parser diagnostics and structured issue reporting.
+  - Support for the latest **RC 6** mode-declaration behavior.
+  - Improved handling of duplicate sections and duplicate keys.
+  - Improved section marker parsing, including marker separators.
+  - Improved string concatenation validation.
+  - Improved EOF handling for files without a final trailing newline.
+  - And more.
+
+- **Improved:** Included `docs/CHANGELOG.md` in the package.
+- Fixed CLI parse error reporting so parse failures are printed by `yini-cli` instead of relying on the parser library to write diagnostics directly to `stderr`.
+- Updated validation behavior to support the newer parser diagnostics model, including `passed-with-warnings` results for valid files that produce warnings.
+- Updated tests and fixtures for the newer parser behavior, including coverage for valid files without a final newline at EOF.
+- Confirmed that `yini-cli` remains quiet by default for JSON validation output, while text-mode validation still reports user-facing diagnostics where appropriate.
+
+## 1.4.0 - 2026 Apr
+- Bumped dependency `yini-parser` to `^1.5.0` which brings:
+  - **Updated** to match **YINI Specification RC.5**: includes synced grammar files and the latest section-header parsing rules.
+  - **Stricter**, more predictable strict mode: now requires exactly one explicit top-level section and a closing `/END` terminator.
+  - **Improved** parser reliability overall: better handling of null/empty values, cleaner `throwOnError` behavior, and expanded validation and test coverage.
+- **Added:** New `validate` command.
+  ```txt
+  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.
+
+  Options:
+    --warnings-as-errors  Treat warnings as errors for exit code purposes.
+    --stats               In text mode, stats only shown when file mode validates exactly one file.
+    --format <type>       Output format for validation results: text | json (choices: "text", "json",
+                          default: "text")
+    --fail-fast           Stop after first file that fails validation.
+    --max-errors <n>      Stop after N total errors (across files).
+    --no-recursive        Do not scan subdirectories.
+    -h, --help            Display full help for all commands.
+  ```
+- **Changed:** The short flag for strict mode is now `-S` (capital). Lowercase `-s` is now reserved for `--silent`, which aligns better with common CLI conventions.
+- **Improved:** Improved the usability of the `parse` command.
+- **Improved:** Test fixtures and CLI tests were reorganized for better clarity, separation, and Windows-safe argument handling.
+
+## 1.3.4 - 2026 Apr
+- **Promoted** YINI CLI is now considered stable (non-beta) after iterative beta releases and refinements.
+- **Fixed:** Rebuilt the project and reduced reported from 9 vulnerabilities (5 moderate, 4 high) to 0.
+- **Updated:** Bumped dependency `yini-parser` to `^1.4.3`.
+
+## 1.3.4-beta - 2026 Mar
+- **Updated:** Bumped dependency `yini-parser` to `^1.4.3-beta` that consists of:
+  - Fixed: Error messages and thrown parse errors now include correct line and column information again.
+  - Improved: Syntax and string-related parse errors are now clearer and more consistent.
+  - Improved: Reduced some duplicate follow-up errors during recovery after invalid input.
+
+## 1.3.3-beta - 2026 Mar
+- **Updated:** Bumped dependency `yini-parser` to `^1.4.2-beta`.
+
+## 1.3.2-beta - 2026 Mar
+- **Updated:** Bumped dependency `yini-parser` to `^1.4.1-beta`.
+- **Fixed:** `parse` now returns a non-zero exit code for invalid input that does not produce usable parsed output.
+- **Improved:** Better alignment with the latest parser diagnostics and recovery behavior.
+- **Improved:** `parse` command file output behavior.
+  - Added fast pre-check to skip parsing when the destination is newer than the source.
+  - Centralized output write policy and skip detection.
+- **Improved:** Avoid unnecessary file rewrites when generated output is unchanged.
+
+## 1.3.1-beta - 2026 Mar
+- **Improved:** `parse` command file write policy.
+  - Destination files newer than the source are now **skipped with a warning** instead of causing an error.
+  - Helps prevent unnecessary build failures in CI pipelines and static site generators (e.g. Astro).
+- **Improved:** Output files are only rewritten when the generated content has actually changed, reducing redundant file writes.
+
+## 1.3.0-beta - 2026 Mar
+- **Updated:** Bumped dependency `yini-parser` to `^1.4.0-beta`.
+- **Added:** CLI now supports parsing/validating **Classic (C) strings** (escape sequences) via the updated parser.
+- **Note:** Default (raw) strings are unchanged (backslashes `\` and `\n` remain as-is unless using `c"..."` / `C'...'`).
+- **Added:** New output formats for the `parse` command:
+  - `--yaml` to export parsed data as **YAML**
+  - `--xml` to export parsed data as **XML**
+- **Refactored:** Output format handling internally to improve robustness, simplify debugging, and make the code easier to test and maintain.
+
+## 1.2.1-beta - 2026 Feb
+- **Improved:** `validate` command:
+  - Strengthened `validate` command diagnostics handling and metadata guards.
+  - Replaced unsafe internal assertions with controlled error handling.
+  - Improved silent mode behavior and exit code consistency.
+
+## 1.2.0-beta - 2026 Feb
+- **Improved:** Updated `--help` to display full help for all commands, while preserving command-specific help through `yini help <command>`.
+- **Changed:** Showing extended information now uses the `info` command only. The global `--info` option has been removed — please use `yini info` instead.
+- **Updated:** `parse` command:
+  - Deprecated `--pretty` (JSON is now the default; use `--json` explicitly if desired).
+  - `--compact` now outputs compact JSON (no whitespace).
+  - Added `--js` option to output JavaScript-style objects.
+  - Improved `--output` file handling:
+    - By default, the output file is written only if it does not exist or is older than the source YINI file.
+    - Added `--overwrite` to always replace existing files.
+    - Added `--no-overwrite` to prevent replacing existing files.
+
+## 1.1.1-beta - 2025 Dec
+- **Updated:** Updated to use the latest YINI Parser version `1.3.2-beta` from `1.3.0-beta`.
+
+## 1.1.0-beta - 2025 Sep
+- **New command:** New command `validate` to validate parsing of a YINI file.
+- **Added** --strict as global option, to enable parsing in strict mode.
+- **Added** -q, --quiet as global option, to reduce output (show only errors).
+- **Added** --silent as global option, will suppress all output (even errors, exit code only).
+- **CI/Tooling (GitHub Actions):** Added security and quality checks:
+  - **Security:** CodeQL, dependency checke (`npm audit`) + lockfile-lint, Gitleaks (SARIF), Semgrep (SARIF).
+  - **CI CLI test**.
+  - **Regression tests:** run across a Node/OS matrix.
+  - **Releases:** npm publish with provenance (tag-driven).
+- Removed per-command --strict flags.
+
+## 1.0.3-beta - 2025 Sep
+- **Updated:** Now uses latest `yini-parser` library `v1.1.0-beta`, for greatly improved parsing, compatibility, and error handling with more descriptive and accurate error messages.
+
+## 1.0.2-beta - 2025 Aug
+- Bumped internal YINI Parser library to version 1.0.2-beta, which fixes and improves number parsing to fully support negative values and edge cases for integers, floats, hexadecimal, binary, octal, duodecimal, and exponential numbers.
+- Added this file into the repo.
+
+---
+
+**^YINI ≡**  
+> A simple, structured, and human-friendly configuration format.  
+
+[yini-lang.org](https://yini-lang.org) · [YINI on GitHub](https://github.com/YINI-lang)  

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "yini-cli",
-    "version": "1.3.4",
-    "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.",
+    "version": "1.5.0",
+    "description": "Official command-line tool for validating and converting YINI files — YINI is an INI-inspired, human-readable configuration format with explicit structure and predictable parsing.",
     "keywords": [
         "yini",
         "cli",
@@ -26,19 +26,20 @@
         }
     },
     "bin": {
-        "yini": "./dist/index.js"
+        "yini": "dist/index.js"
     },
     "homepage": "https://yini-lang.org/",
     "license": "Apache-2.0",
     "files": [
         "dist/",
         "README.md",
+        "docs/CHANGELOG.md",
         "LICENSE",
         "sample.yini"
     ],
     "repository": {
         "type": "git",
-        "url": "https://github.com/YINI-lang/yini-cli.git"
+        "url": "git+https://github.com/YINI-lang/yini-cli.git"
     },
     "private": false,
     "scripts": {
@@ -51,7 +52,7 @@
         "run:parse": "npm run start -- parse sample.yini",
         "run:validate": "npm run start -- validate sample.yini",
         "test:smoke": "vitest tests/smoke",
-        "test:general": "vitest tests/general",
+        "test:general": "vitest tests/global-options.test.ts",
         "test": "vitest run",
         "test:debug": "cross-env isDebug=1 vitest run --reporter=verbose",
         "test:general:debug": "cross-env isDebug=1 npm run test:general",
@@ -63,7 +64,7 @@
         "format": "prettier --check .",
         "format:fix": "prettier --write .",
         "build": "tsc",
-        "clean": "rm -rf dist",
+        "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
         "prepare": "npm run build",
         "prepublishOnly": "npm run lint && npm test && npm run build"
     },
@@ -72,12 +73,12 @@
         "commander": "^14.0.1",
         "xmlbuilder2": "^4.0.3",
         "yaml": "^2.8.2",
-        "yini-parser": "^1.4.3"
+        "yini-parser": "^1.6.0"
     },
     "devDependencies": {
         "@eslint/js": "^9.31.0",
         "@ianvs/prettier-plugin-sort-imports": "^4.4.2",
-        "@types/node": "^22.15.3",
+        "@types/node": "^22.19.19",
         "@typescript-eslint/eslint-plugin": "^8.37.0",
         "@typescript-eslint/parser": "^8.37.0",
         "cross-env": "^7.0.3",
@@ -87,7 +88,7 @@
         "execa": "^9.6.0",
         "husky": "^9.1.7",
         "lint-staged": "^16.0.0",
-        "nyc": "^17.1.0",
+        "nyc": "^18.0.0",
         "prettier": "^3.5.3",
         "tsx": "^4.7.0",
         "typescript": "^5.8.3",
@@ -95,10 +96,10 @@
     },
     "lint-staged": {
         "src/**/*.{js,jsx,json,ts,tsx,css,scss}": [
-            "prettier --config ./.prettierrc --write"
+            "prettier --config ./prettier.config.cjs --write"
         ]
     },
     "engines": {
-        "node": ">=13"
+        "node": ">=18"
     }
 }