yini-parser 1.4.3-beta → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # CHANGELOG
 
+## 1.5.0 - 2026 Apr
+- **Updated:** Parser behavior aligned with YINI Specification `v1.0.0-RC.5`.
+- **Changed:** In strict mode, YINI documents must now end with the document terminator `/END`.
+- **Changed:** Strict mode now requires exactly one explicit top-level section.
+- **Updated:** Section header parsing now reflects the latest horizontal whitespace (`HSPACE`) rules from the specification.
+- **Improved:** Refined how members outside explicit sections are handled in lenient mode, and added stricter checks for top-level structure in strict mode.
+- **Improved:** Clarified and tightened how empty values and explicit `null` are handled in lenient and strict mode.
+- **Improved:** Fixed `throwOnError` option detection, clarified the related documentation, and cleaned up public parameter names.
+- **Fixed:** Made `throwOnError` work consistently together with the selected fail level.
+- **Updated:** Synced to the latest lexer and parser grammar files from the Specification Package `v1.0.0-RC.5`, with cleaned up and refined grammar files for better consistency and maintainability.
+- **Added:** Expanded validation and tests for section headers, including shorthand markers, backticked names, and invalid dotted section names.
+- **Expanded:** Improved integration and smoke test coverage for error recovery, throw behavior, null handling, fixture parsing, and section/header edge cases.
+- **Updated:** Added and validated a new large smoke/golden fixture:
+  - `tests/fixtures/smoke-fixtures/c-industrial-monitoring-and-automation-platform.smoke.yini`
+- **Improved:** Fixed and re-enabled previously skipped smoke tests:
+  - `tests/fixtures/smoke-fixtures/8-api-keys-integration.smoke.yini`
+  - `tests/fixtures/smoke-fixtures/9-app-preferences.smoke.yini`
+
+## 1.4.3 - 2026 Apr
+- **Promoted:** YINI Parser TypeScript is now considered stable (non-beta) after iterative beta releases and refinements.
+- **Fixed:** Rebuilt the project and reduced reported vulnerabilities from 4 to 0.
+  
 ## 1.4.3-beta - 2026 Mar
 - **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.

package/README.md

@@ -1,145 +1,68 @@
-# YINI Parser for Node.js
-> **Readable configuration without YAML foot-guns or JSON noise.**  
+# yini-parser
+> **Readable configuration for Node.js and TypeScript/JavaScript — without YAML footguns or JSON noise.**  
 
-The official TypeScript / Node.js parser for **YINI** (by the YINI-lang project) — an INI-inspired, human-readable text format for structured information.  
+The official TypeScript / Node.js parser for **YINI** (by the YINI-lang project) — a human-friendly configuration format with clear structure, nested sections, comments, and predictable parsing.
 
-[![npm version](https://img.shields.io/npm/v/yini-parser.svg)](https://www.npmjs.com/package/yini-parser) [![All Test Suites](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-all-tests.yml/badge.svg)](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-all-tests.yml) [![All Regression Tests](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-regression-tests.yml/badge.svg)](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-regression-tests.yml) [![Grammar Drift Check](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-grammar-drift-check.yml/badge.svg)](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-grammar-drift-check.yml) [![npm downloads](https://img.shields.io/npm/dm/yini-parser)](https://www.npmjs.com/package/yini-parser)
+YINI is designed for applications, tools, and services that need configuration that stays readable for humans without becoming vague, fragile, or hard to maintain.  
 
-Designed to bring structure, clarity, and predictable behavior to real-world configuration needs. Well suited for applications, tools, and services that need readable yet structured configuration.
+[![npm version](https://img.shields.io/npm/v/yini-parser.svg)](https://www.npmjs.com/package/yini-parser) [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![All Test Suites](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-all-tests.yml/badge.svg)](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-all-tests.yml) [![All Regression Tests](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-regression-tests.yml/badge.svg)](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-regression-tests.yml) [![Grammar Drift Check](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-grammar-drift-check.yml/badge.svg)](https://github.com/YINI-lang/yini-parser-typescript/actions/workflows/run-grammar-drift-check.yml) [![npm downloads](https://img.shields.io/npm/dm/yini-parser)](https://www.npmjs.com/package/yini-parser)  
+
+## Quick Start
 
 ```sh
 npm install yini-parser
 ```
 
-```ts
-import YINI from 'yini-parser'
-const config = YINI.parseFile('./config.yini')
-```
-
-```sh
-npm run test
-```
-
-➡️ See full [documentation or YINI format specification](https://github.com/YINI-lang/YINI-spec)
-
----
-
-## Example of YINI code
-> A basic YINI configuration example, showing a section, nested section, comments:  
-![YINI Config Example](./samples/basic.yini.png)
-Source: [basic.yini](./samples/basic.yini)
-
-## YINI Parser – (source code in TypeScript)
-
-A runtime parser for the official [YINI configuration file format](https://github.com/YINI-lang/YINI-spec).  
-
-The parser follows the official YINI specification and is implemented in TypeScript.
-
----
-
-## Quick Start
-
-A small example using YINI in TypeScript/JavaScript:
 ```ts
 import YINI from 'yini-parser'
 
 const config = YINI.parse(`
-    // YINI is a simple, human-readable configuration file format.
-
-    // Note: In YINI, spaces and tabs never change meaning.
-    // Indentation is only for readability.
+^ App
+name = 'My App'
+darkMode = true
 
-    ^ App                      // Definition of section (group) "App" 
-      name     = 'My Title'    // Keys and values are written as key = value
-      items    = 25
-      darkMode = true          // "ON" and "YES" works too
-
-        // Sub-section of the "App" section
-        ^^ Special
-           primaryColor = #336699   // Hex number format
-           isCaching    = false     // "OFF" and "NO" works too
+    ^^ Features
+    caching = on
 `)
 
-// To parse from a file instead:
-// const config = YINI.parseFile('./config.yini')
-
-console.log(config.App.name)                // My Title
-console.log(config.App.Special.isCaching)   // false
-console.log()
-console.log(config)
+console.log(config.App.name)              // My App
+console.log(config.App.Features.caching)  // true
 ```
 
-**Output:**
-```js
-My Title
-false
-
-{
-    App: {
-        name: 'My Title',
-        items: 25,
-        darkMode: true,
-        Special: { 
-            primaryColor: 3368601,
-            isCaching: false
-        }
-    }
-}
-```
-
-That's it!
-
-- ▶️ Link to [Demo Apps](https://github.com/YINI-lang/yini-demo-apps/tree/main) with complete basic usage.
-
----
-
-## Example 2
-> A real-world YINI configuration example, showing sections, nesting, comments, and multiple data types:  
-![YINI Config Example](./samples/config.yini.png)
-Source: [config.yini](./samples/config.yini)
-
-## 📂 More Examples
-
-- ▶️ Explore more [YINI examples](https://yini-lang.org/learn-yini/examples/?utm_source=yini-parser-ts&utm_medium=github&utm_campaign=repo-link&utm_content=readme).
-
----
-
-### Who is this for?
-
-YINI is designed as an ideal option for application developers, platform teams, DevOps engineers, and anyone maintaining complex configuration at scale.
+➡️ Learn more in the [YINI specification and documentation](https://yini-lang.org/refs/specification).
 
 ---
 
-## 🙋‍♀️ Why YINI?
-- **Indentation-independent structure:** The YINI config format is indentation-independent, meaning spaces and tabs never affect meaning.
-- **Explicit nesting for easy refactoring & large configs:** It uses clear header markers (`^`, `^^`, `^^^`) to define hierarchy (like in Markdown), without long dotted keys.
-- **Multiple data types:** Supports boolean literals (`true` / `false`, `Yes` / `No`, etc), numbers, arrays (lists), and JS-style objects natively, with explicit string syntax.
-- **Comments support:** YINI supports multiple comment styles (`#`, `//`, `/* ... */`, and `;`). Allows you to document configuration directly in the file.
-- **Predictable parsing rules:** Fewer production surprises, well-defined rules with optional strict and lenient modes, for different use cases.
+## 🙋‍♀️ Why try YINI?
 
+- **Readable by humans** — Less noisy than JSON, less fragile than indentation-driven formats.
+- **Structured for real-world configuration** — Sections, nested sections, lists, objects, booleans, and null.
+- **Predictable parsing** — Explicit syntax with clear rules.
+- **Easy to use from TypeScript/Node.js** — Parse from strings or files in a few lines.
+  
 ---
 
-## ✨ Features
-- Simple syntax (supports both strict and lenient modes).
-- Familiar config file style (inspired by INI, JSON, Python, and Markdown).
-- Easy programmatic usage.
-- Only the `YINI` class is exported; all internal details are private.
-- Arrays/Lists (bracketed): `list = [10, 20, 30]`
-- JavaScript-style objects (inline maps).
+## What YINI looks like in practice
+> A basic YINI configuration example, showing a section, a nested section, and comments:  
+![YINI Config Example](./samples/basic.yini.png)
+Source: [basic.yini](./samples/basic.yini)
 
-⭐ If you find this useful, please consider starring the project on GitHub.
+- ▶️ [Demo Apps](https://github.com/YINI-lang/yini-demo-apps/tree/main) with complete usage examples.
 
 ---
 
-## 🧪 Stability & Guarantees
-
-This parser is continuously validated through comprehensive regression and smoke tests, ensuring deterministic parsing behavior across default, strict, and metadata-enabled modes.
+## Why YINI works well for configuration
+- **Indentation-independent structure:** Spaces and tabs never change meaning, so files can be reformatted without changing structure.
+- **Explicit nesting:** Hierarchy is defined with section markers like `^`, `^^`, and `^^^`, making large configurations easier to scan and refactor.
+- **Multiple data types:** Supports booleans (`true` / `false`, `yes` / `no`, etc.), numbers, lists, and inline objects, with explicit string syntax.
+- **Comment support:** YINI supports multiple comment styles (`#`, `//`, `/* ... */`, and `;`), making it easy to document configuration directly in the file.
+- **Predictable parsing:** Clear rules with optional strict and lenient modes for different use cases.
 
 ---
 
 ## Usage
 
-### Installation
+### Install with your package manager
 
 With **npm**:
 ```sh
@@ -160,8 +83,7 @@ pnpm add yini-parser
 **Note:** Only a default export (YINI) is provided. Named imports are not supported.
 ```js
 const YINI = require('yini-parser').default;
-// (!) If you get undefined, try:
-// (Some Node.js setups require the .default property, others don't, due to ESM/CommonJS interop quirks.)
+// If your setup handles default interop differently, try:
 // const YINI = require('yini-parser');
 
 // Parse from string.
@@ -206,56 +128,58 @@ const configFromFile = YINI.parseFile('./config.yini');
 
 ---
 
-## 🛠 Roadmap
-
-1. **Improve existing functionality** — Ongoing improvements to core parsing, richer diagnostics, and expanded QA for areas not yet fully covered.
-2. **Full spec compliance** — Complete support for all features in the YINI Specification v1.0.0 (and the latest RCs).
-   - Progress and current status are tracked in [FEATURE-CHECKLIST.md](https://github.com/YINI-lang/yini-parser-typescript/blob/main/FEATURE-CHECKLIST.md).
-3. **Schema validation (future)** — Possible future expansion to support schema/contract validation for stricter type-safe configs.
-4. **Ecosystem integration** - Broader and additional support for tooling, and other ecosystem projects.
+## 📂 More Examples
 
-### Planned & Upcoming Features
-Some advanced YINI features are still evolving and are tracked transparently.
+- ▶️ Explore more [YINI examples](https://yini-lang.org/learn-yini/examples/?utm_source=yini-parser-ts&utm_medium=github&utm_campaign=repo-link&utm_content=readme).
 
-You can follow progress in the [YINI parser FEATURE-CHECKLIST](https://github.com/YINI-lang/yini-parser-typescript/blob/main/FEATURE-CHECKLIST.md). Contributions and feature requests are welcome!
+### Example 2
+> A real-world YINI configuration example, showing sections, nesting, comments, and multiple data types:  
+![YINI Config Example](./samples/config.yini.png)
+Source: [config.yini](./samples/config.yini)
 
 ---
 
-## 🤝 Contributing
-We welcome feedback, bug reports, feature requests, and code contributions!
-- [Open an Issue](https://github.com/YINI-lang/yini-parser-typescript/issues)
-- [Start a Discussion](https://github.com/YINI-lang/yini-parser-typescript/discussions)
-  
-
-If this library is useful to you, a GitHub star helps guide future development.
+## 🧪 Testing and Stability
 
----
-
-## 📚 Documentation
-- [Project Setup](https://github.com/YINI-lang/yini-parser-typescript/blob/main/docs/Project-Setup.md) — How to run, test, and build the project, etc.
-- [Conventions](https://github.com/YINI-lang/yini-parser-typescript/blob/main/docs/Conventions.md) — Project conventions, naming patterns, etc.
+This parser is validated through regression and smoke tests to help ensure stable, predictable parsing across default, strict, and metadata-enabled modes.
 
 ---
 
 ## Links
-- ➡️ [Read the YINI Specification](https://github.com/YINI-lang/YINI-spec/tree/production/YINI-Specification.md#table-of-contents)  
-  *Full formal spec for the YINI format, including syntax and features.*
+- ➡️ [YINI Homepage](https://yini-lang.org)  
+  *Tutorials, guides, and examples.*
+
+- ➡️ [Read the YINI Specification](https://yini-lang.org/refs/specification)  
+  *Full syntax and format reference.*
 
 - ➡️ [YINI CLI on GitHub](https://github.com/YINI-lang/yini-cli)  
-  *TypeScript source code, issue tracker, and contributing guide.*
+  *CLI tooling for working with YINI files.*
 
-- ➡️ [YINI Project](https://github.com/YINI-lang)  
-  *YINI home on GitHub.*
+- ➡️ [Demo Apps](https://github.com/YINI-lang/yini-demo-apps/tree/main)  
+  *Complete basic usage examples.*
 
-- ➡️ [YINI Homepage](https://yini-lang.org)  
-  *Tutorials & Docs.*
+- ➡️ [YINI-lang Project](https://github.com/YINI-lang)  
+  *Repositories and related ecosystem projects.*
+
+---
+
+## 🤝 Contributing
+Feedback, bug reports, feature requests, and code contributions are welcome.
+- [Open an Issue](https://github.com/YINI-lang/yini-parser-typescript/issues)
+- [Start a Discussion](https://github.com/YINI-lang/yini-parser-typescript/discussions)
+  
+If this library is useful to you, a GitHub star helps more people discover the project and supports future development.
+
+### Documentation
+- [Project Setup](https://github.com/YINI-lang/yini-parser-typescript/blob/main/docs/Project-Setup.md) — How to run, test, and build the project, etc.
+- [Conventions](https://github.com/YINI-lang/yini-parser-typescript/blob/main/docs/Conventions.md) — Project conventions, naming patterns, etc.
 
 ---
 
 ## License
-This project is licensed under the Apache-2.0 license - see the [LICENSE](<./LICENSE>) file for details.
+This project is licensed under the Apache License 2.0 — see the [LICENSE](./LICENSE) file for details.
 
-In this project on GitHub, the `libs` directory contains third party software and each is licensed under its own license which is described in its own license file under the respective directory under `libs`.
+In this project on GitHub, the `libs` directory contains third-party software and each is licensed under its own license, described in its own license file under the respective directory under `libs`.
 
 ---
 
@@ -264,4 +188,4 @@ In this project on GitHub, the `libs` directory contains third party software an
 > 
 > Predictable configuration with clear rules.  
 
-[yini-lang.org](https://yini-lang.org/?utm_source=github&utm_medium=referral&utm_campaign=yini_parser_ts&utm_content=readme_footer) · [YINI on GitHub](https://github.com/YINI-lang)  
+[yini-lang.org](https://yini-lang.org/?utm_source=github&utm_medium=referral&utm_campaign=yini_parser_ts&utm_content=readme_footer) · [YINI-lang on GitHub](https://github.com/YINI-lang)  

package/dist/YINI.d.ts

@@ -1,8 +1,8 @@
 import { ParsedObject, ParseOptions, PreferredFailLevel, YiniParseResult } from './types';
 /**
- * This class is the public API, which exposes only parse(..) and
- * parseFile(..), rest of the implementation details are hidden.
- * @note Only parse and parseFile are public.
+ * This class is the main public API. It exposes `parse(..)` and `parseFile(..)`
+ * as the primary entry points, while the implementation details remain internal.
+ * @note The public parsing API is exposed through `parse(..)` and `parseFile(..)`.
  */
 export default class YINI {
     private static g_tabSize;
@@ -73,16 +73,14 @@ export default class YINI {
      *   Does not affect warnings included in returned metadata.
      * @param options.requireDocTerminator - Controls whether a document terminator is required.
      *   Allowed values: `'optional'` | `'warn-if-missing'` | `'required'`.
-     * @param options.silent - Suppress all output (even errors, exit code only).
+     * @param options.silent - Suppress all console output, including errors and warnings.
      * @param options.strictMode - Sets the baseline ruleset (true = strict, false = lenient).
      *   This is only a starting point: rule-specific options (e.g., `treatEmptyValueAsNull`,
      *   `onDuplicateKey`, etc.) can override parts of that ruleset. If any overrides are given,
      *   the effective mode becomes **custom** rather than purely strict/lenient.
      * @param options.treatEmptyValueAsNull - How to treat an explicitly empty value on the
      *   right-hand side of '='. Allowed values: `'allow'` | `'allow-with-warning'` | `'disallow'`.
-     * @param options.throwOnError - Will throw on first parse error encountered.
-     * NOTE: Current default is `true`. The default will change to `false` in the next
-     * release. To avoid breaking changes, set this option explicitly.
+     * @param options.throwOnError - Throw when a parse issue reaches the active bail threshold (for example, on errors if `failLevel = 'errors'`).
      *
      * @returns {ParsedObject | YiniParseResult} The parsed YINI content.
      *
@@ -106,7 +104,7 @@ export default class YINI {
     /**
      * Parse a YINI file into a JavaScript object.
      *
-     * @param yiniFile           Path to the YINI file.
+     * @param filePath           Path to the YINI file.
      * @param strictMode         If `true`, enforce strict parsing rules (e.g. require `/END`, disallow trailing commas).
      * @param failLevel          Preferred bail sensitivity level, controls if and when parsing should stop on problems:
      *   - `'auto'` (default)      : Auto‑select level (strict → `'errors'`, lenient → `'ignore-errors'`)
@@ -137,7 +135,7 @@ export default class YINI {
     /**
      * Parse a YINI file into a JavaScript object, using an options object for configuration.
      *
-     * @param yiniFile Path to the YINI file.
+     * @param filePath Path to the YINI file.
      * @param options Optional settings to customize parsing and/or results, useful if you need more control.
      *        For all options, see types/ParseOptions.
      *
@@ -161,16 +159,14 @@ export default class YINI {
      *   Does not affect warnings included in returned metadata.
      * @param options.requireDocTerminator - Controls whether a document terminator is required.
      *   Allowed values: `'optional'` | `'warn-if-missing'` | `'required'`.
-     * @param options.silent - Suppress all output (even errors, exit code only).
+     * @param options.silent - Suppress all console output, including errors and warnings.
      * @param options.strictMode - Sets the baseline ruleset (true = strict, false = lenient).
      *   This is only a starting point: rule-specific options (e.g., `treatEmptyValueAsNull`,
      *   `onDuplicateKey`, etc.) can override parts of that ruleset. If any overrides are given,
      *   the effective mode becomes **custom** rather than purely strict/lenient.
      * @param options.treatEmptyValueAsNull - How to treat an explicitly empty value on the
      *   right-hand side of '='. Allowed values: `'allow'` | `'allow-with-warning'` | `'disallow'`.
-     * @param options.throwOnError - Will throw on first parse error encountered.
-     * NOTE: Current default is `true`. The default will change to `false` in the next
-     * release. To avoid breaking changes, set this option explicitly.
+     * @param options.throwOnError - Throw when a parse issue reaches the active bail threshold (for example, on errors if `failLevel = 'errors'`).
      *
      * @returns {ParsedObject | YiniParseResult} The parsed YINI content.
      *

package/dist/YINI.js

@@ -7,9 +7,9 @@ const runtime_1 = require("./core/runtime");
 const print_1 = require("./utils/print");
 const DEFAULT_TAB_SIZE = 4; // De facto "modern default" (even though traditionally/historically it's 8).
 /**
- * This class is the public API, which exposes only parse(..) and
- * parseFile(..), rest of the implementation details are hidden.
- * @note Only parse and parseFile are public.
+ * This class is the main public API. It exposes `parse(..)` and `parseFile(..)`
+ * as the primary entry points, while the implementation details remain internal.
+ * @note The public parsing API is exposed through `parse(..)` and `parseFile(..)`.
  */
 class YINI {
     /**

package/dist/YINI.js.map

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

package/dist/core/astBuilder.d.ts

@@ -1,4 +1,4 @@
-import { AnnotationContext, AssignmentContext, Bad_memberContext, Bad_meta_textContext, Boolean_literalContext, Colon_list_declContext, DirectiveContext, ElementsContext, EolContext, List_literalContext, MemberContext, Meta_stmtContext, Null_literalContext, Number_literalContext, Object_literalContext, Object_memberContext, Object_membersContext, PrologContext, StmtContext, String_concatContext, String_literalContext, Terminal_stmtContext, ValueContext, YiniContext } from '../grammar/generated/YiniParser.js';
+import { AnnotationContext, AssignmentContext, Bad_memberContext, Bad_meta_textContext, Boolean_literalContext, DirectiveContext, ElementsContext, EolContext, List_literalContext, MemberContext, Meta_stmtContext, Null_literalContext, Number_literalContext, Object_literalContext, Object_memberContext, Object_membersContext, PrologContext, StmtContext, String_concatContext, String_literalContext, Terminal_stmtContext, ValueContext, YiniContext } from '../grammar/generated/YiniParser.js';
 import YiniParserVisitor from '../grammar/generated/YiniParserVisitor';
 import { ErrorDataHandler } from './errorDataHandler';
 import { IParseCoreOptions, IYiniAST, TSourceType } from './internalTypes';
@@ -28,6 +28,7 @@ export default class ASTBuilder<Result> extends YiniParserVisitor<Result> {
      * @param metaLineCount Provide the line-count here so the meta information can be updated accordingly.
      */
     constructor(errorHandler: ErrorDataHandler, options: IParseCoreOptions, sourceType: TSourceType, metaFileName: string | null);
+    private validateStrictTopLevelStructure;
     private hasDefinedSectionTitle;
     private setDefineSectionTitle;
     private extractStringParts;
@@ -166,12 +167,8 @@ export default class ASTBuilder<Result> extends YiniParserVisitor<Result> {
      */
     visitObject_member: (ctx: Object_memberContext) => any;
     /**
-     * Visit a parse tree produced by `YiniParser.colon_list_decl`.
-     * @param ctx the parse tree
-     * @grammarRule KEY WS? COLON (eol | WS+)* elements (eol | WS+)* eol
-     * @return the visitor result
+     * @note Colon list not supported any more since YINI Spec Package v1.0.0.rc4
      */
-    visitColon_list_decl: (ctx: Colon_list_declContext) => any;
     /**
      * Visit a parse tree produced by `YiniParser.string_concat`.
      * @param ctx the parse tree