yini-parser 1.3.2-beta → 1.4.0-beta

package/CHANGELOG.md

@@ -1,8 +1,47 @@
 # CHANGELOG
 
+## 1.4.0-beta - 2026 Feb
+
+### ✨ Added
+- Full implementation of **Classic (C) string literals** (`c"..."`, `C'...'`) according to specification section 6.2.
+- Complete support for all defined escape sequences:
+  - `\\`, `\'`, `\"`, `\/`
+  - `\0`, `\?`, `\a`, `\b`, `\f`, `\n`, `\r`, `\t`, `\v`
+  - `\xhh` (2-digit hex)
+  - `\uhhhh` (UTF-16)
+  - `\Uhhhhhhhh` (UTF-32)
+  - `\oOOO` (octal, up to 3 digits, range `\o0`–`\o377`)
+
+### 🔒 Improved
+- Strict validation of invalid escape sequences (e.g. `\z`, malformed `\x`, `\u`, `\U`, `\o`).
+- Enforcement of control character rules (U+0000–U+001F must be escaped in Classic strings).
+- Proper handling of Classic string concatenation (`+`) including mixed raw + classic combinations.
+
+### 🧪 Tests
+- Expanded integration test coverage for Classic strings.
+- Added validation tests for all escape types and error conditions.
+
+---
+
+## 1.3.3-beta - 2025 Dec
+This release strengthens correctness and reliability, while preserving the existing API and improving guarantees.
+- **Added:** 
+  - Added comprehensive smoke tests (F-5.a-d and F-6.a-d) matching YINI parsing against expected JSON output using two large, production-style configuration examples.
+    - **Corporate SaaS Platform** — [YINI](./tests/fixtures/smoke-fixtures/a-corporate-saas-platform.smoke.yini) and [JSON](./tests/fixtures/smoke-fixtures/a-corporate-saas-platform.smoke.json)
+    - **High-Security Distributed Control System** — [YINI](./tests/fixtures/smoke-fixtures/b-high-security-distributed-control-system.smoke.yini) and [JSON](./tests/fixtures/smoke-fixtures/b-high-security-distributed-control-system.smoke.json)
+  - Tests verify consistent results across:
+    - default parsing.
+    - strict mode parsing.
+    - strict mode with metadata enabled.
+  - These tests now serve as regression contracts for parser correctness, metadata inclusion, and cross-format consistency.
+- **Added:** Smoke test (F-7) verifying that parsing a YINI file returns metadata when `includeMetadata: true` is enabled.
+- **Added:** Smoke test (F-8) verifying that parsing a defect YINI produces diagnostics metadata given proper parse options.
+- **Fixed:** Miscellaneous smaller fixes and improvements
+  
 ## 1.3.2-beta - 2025 Dec
 - **Added:** Implemented UTF-8 BOM support (safe U+FEFF stripping) and added complete test fixtures for BOM/no-BOM, BOM+newline, and mid-file scenarios.
-- **Added:** Implemented support for shebang (`#!`), which is ignored by the parser.
+- **Added:** Implemented support for shebang (`#!`), which is ignored by the parser and the line skipped.  
+(If the parser sees `#!` at first line, instead of breaking the parsing, the parsing will continue on the next line.)
 - **Updated:** all (~14) project dependencies to their latest versions, including TypeScript and packages with reported security vulnerabilities. Node type definitions remain unchanged.
 
 ## 1.3.0-beta - 2025 Sep

package/README.md

@@ -1,9 +1,12 @@
 # YINI Parser for Node.js
+> **Readable configuration without YAML foot-guns or JSON noise.**  
 
-A TypeScript/Node.js parser for YINI — A type-safe, structured, and human-readable config format with nested sections, types, comments, and support for strict validation.
+The official TypeScript / Node.js parser for **YINI** — an INI-inspired, human-readable text format for structured information.  
 
 [![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)
 
+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.
+
 ```sh
 npm install yini-parser
 ```
@@ -13,45 +16,25 @@ import YINI from 'yini-parser'
 const config = YINI.parseFile('./config.yini')
 ```
 
-YINI (Yet another INI): YINI is a configuration format designed for readability and structure, inspired by INI and YAML.
+```sh
+npm run test
+```
 
 ➡️ See full [documentation or YINI format specification](https://github.com/YINI-lang/YINI-spec)
 
-⭐ **Enjoying YINI?** If you think this project is interesting, [consider giving it a star on GitHub](https://github.com/YINI-lang/yini-parser-typescript) — it's greatly appreciated.
-
 ---
 
-## YINI Parser – (source code in TypeScript)
-
-**YINI Parser in TypeScript** — a runtime library for Node.js.  
-A parser / reader for the [YINI configuration file format](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)
 
-This library implements the official YINI specification using TypeScript + ANTLR4.
-
-YINI is a simple, human-friendly configuration format inspired by INI and JSON.
-
----
+## YINI Parser – (source code in TypeScript)
 
-## 🙋‍♀️ Why YINI?
-- **YINI is an alternative** to other great config formats like INI, JSON, YAML, XML, and TOML — Supports section nesting and explicit syntax for configuration files.
-- **Started as a personal project and a research challenge:** Provides structure similar to INI, with features inspired by JSON and YAML.
-- **Built for clarity:**
-    * Uses a concise syntax to minimize unnecessary characters.
-    * Supports commonly used configuration structures.
-- Developed to meet practical needs, driven by curiosity and a desire **for configuration clarity, simplicity, minimalism, and flexibility**.
+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.
 
-## 💡 What is YINI?
-- **Simple like INI** — but with strong typing, comments, and nested sections.
-- **Provides concise, structured syntax** for configuration.
-- Supports section nesting **without requiring indentation or dot-delimited keys**.
-- This repo/parser is built for both **JavaScript and TypeScript**.
-- **Supports strict and lenient modes**, and all major data types.
-- Can be **edited manually** or **processed programmatically**.
-- 👉 See [how YINI compares with JSON, YAML, INI, and TOML](https://github.com/YINI-lang/yini-parser-typescript/tree/main/examples/compare-formats.md).
-- Want the full syntax reference? See the [YINI Specification](https://github.com/YINI-lang/YINI-spec).
-  
 ---
 
 ## Quick Start
@@ -63,8 +46,8 @@ import YINI from 'yini-parser'
 const config = YINI.parse(`
     // YINI is a simple, human-readable configuration file format.
 
-    // Note: In YINI, spaces and tabs don't change meaning - 
-    // indentation is just for readability.
+    // Note: In YINI, spaces and tabs never change meaning.
+    // Indentation is only for readability.
 
     ^ App                      // Definition of section (group) "App" 
       name     = 'My Title'    // Keys and values are written as key = value
@@ -106,15 +89,51 @@ false
 
 That's it!
 
-- ▶️ Link to [examples/](https://github.com/YINI-lang/yini-parser-typescript/tree/main/examples) files.
 - ▶️ Link to [Demo Apps](https://github.com/YINI-lang/yini-demo-apps/tree/main) with complete basic usage.
 
 ---
 
-## Intro to YINI Config Format
-**YINI** is a simple and readable configuration format. Sections are defined with `^ SectionName`, and values are assigned using `key = value`. The format supports common data types (same as those found in JSON), including strings, numbers, booleans, nulls, and lists. 
+## 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.
+
+---
+
+## 🙋‍♀️ 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.
+
+---
+
+## ✨ 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).
+
+⭐ If you find this useful, please consider starring the project on GitHub.
+
+---
+
+## 🧪 Stability & Guarantees
 
-To learn more, see the [Getting Started: Intro to YINI Config Format](https://github.com/YINI-lang/YINI-spec/blob/develop/Docs/Intro-to-YINI-Config-Format.md) tutorial.
+This parser is continuously validated through comprehensive regression and smoke tests, ensuring deterministic parsing behavior across default, strict, and metadata-enabled modes.
 
 ---
 
@@ -143,7 +162,7 @@ pnpm add yini-parser
 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.)
-const YINI = require('yini-parser');
+// const YINI = require('yini-parser');
 
 // Parse from string.
 const config = YINI.parse(`
@@ -187,137 +206,6 @@ const configFromFile = YINI.parseFile('./config.yini');
 
 ---
 
-## ✨ 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.
-- Lists (bracketed): `list = [10, 20, 30]`
-- 🚧 *(Planned – not yet implemented in parser)* Supports alternative list notation (colon‑style lists):
-    ```yini
-    fruits:
-        'Pear',
-        'Cherry',
-        'Banana'
-    ```
-
-### Limitations
-Not all features of the full YINI are implemented yet.
-
-See [FEATURE-CHECKLIST.md](https://github.com/YINI-lang/yini-parser-typescript/blob/main/FEATURE-CHECKLIST.md) for the current list of implemented YINI features.
-
-## 🚧 Missing or Upcoming Features
-
-This parser currently supports all core YINI syntax for values, comments, section headers, and basic nesting.
-
-The following features from the [YINI specification](https://github.com/YINI-lang/YINI-spec) are **planned but not yet fully implemented**:
-
-- Object literals
-- Advanced escape sequences
-- String types and triple-quoted strings
-- All number format literals
-- Full strict mode validation
-
-You can follow progress in the [YINI parser GitHub repo-FEATURE-CHECKLIST](https://github.com/YINI-lang/yini-parser-typescript/blob/main/FEATURE-CHECKLIST.md). Contributions and feature requests are welcome!
-
-## 📂 Examples
-
-See the [examples/](https://github.com/YINI-lang/yini-parser-typescript/tree/main/examples) folder for:
-
-- Basic YINI file with common types and comments
-- Nested sections example
-- Comparison with JSON/YAML config
-
-These examples are also included in the npm package.
-
----
-
-## Bigger Example
-
-```js
-const YINI = require('yini-parser').default; // Or: import YINI from 'yini-parser';
-
-const config = YINI.parse(`
-    // This is a comment in YINI
-    // YINI is a simple, human-readable configuration file format.
-
-    // Note: In YINI, spaces and tabs don't change meaning - indentation is just
-    // for readability.
-
-    /*  This is a block comment
-
-        In YINI, section headers use repeated characters "^" at the start to
-        show their level: (Section header names are case-sensitive.)
-
-        ^ SectionLevel1
-        ^^ SectionLevel2
-        ^^^ SectionLevel3
-    */
-
-    ^ App                           // Definition of section (group) "App" 
-      title = 'My App'
-      items = 25
-      debug = ON                    // "true" and "YES" works too
-
-    ^ Server                        // Definition of section (group) "Server"
-      host = 'localhost'
-      port = 8080
-      useTLS = OFF                  // "false" and "NO" works too
-
-        // Sub-section of "Server"
-        ^^ Login
-          username = 'user_name'
-          password = 'your_password_here'
-    
-    /END // (only optional)
-`);
-
-console.log(config);
-```
-
-### Output:
-```js
-// JS object
-{
-    App: {
-        title: 'My App', 
-        items: 25, 
-        debug: true
-    },
-    Server: {
-        host: 'localhost',
-        port: 8080,
-        useTLS: false,
-        Login: { 
-            username: 'user_name', 
-            password: 'your_password_here'
-        }
-    }
-}
-```
-
-### Output in JSON:
-```json
-{
-    "App": {
-        "title": "My App",
-        "items": 25,
-        "debug": true
-    },
-    "Server": {
-        "host": "localhost",
-        "port": 8080,
-        "useTLS": false,
-        "Login": {
-            "username": "user_name",
-            "password": "your_password_here"
-        }
-    }
-}
-```
-
----
-
 ## 🛠 Roadmap
 
 1. **Improve existing functionality** — Ongoing improvements to core parsing, richer diagnostics, and expanded QA for areas not yet fully covered.
@@ -326,6 +214,11 @@ console.log(config);
 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.
 
+### Planned & Upcoming Features
+Some advanced YINI features are still evolving and are tracked transparently.
+
+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!
+
 ---
 
 ## 🤝 Contributing
@@ -333,35 +226,29 @@ 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.
+
 ---
 
 ## 📚 Documentation
-- [Development Setup](https://github.com/YINI-lang/yini-parser-typescript/blob/main/docs/Development-Setup.md) — How to run, test, and build the project, etc.
+- [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.
 
 ---
 
 ## Links
-- ➡️ [Getting Started: Intro to YINI Config Format](https://github.com/YINI-lang/YINI-spec/blob/develop/Docs/Intro-to-YINI-Config-Format.md)  
-  *Beginner-friendly walkthrough and basic usage examples.*
-
-- ➡️ [YINI Parser on npm](https://www.npmjs.com/package/yini-parser)  
-  *Install and view package details.*
-
-- ➡️ [Read the YINI Specification](https://github.com/YINI-lang/YINI-spec/blob/release/YINI-Specification.md#table-of-contents)  
+- ➡️ [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 CLI on GitHub](https://github.com/YINI-lang/yini-cli)  
   *TypeScript source code, issue tracker, and contributing guide.*
 
-- ➡️ [YINI vs Other Formats](https://github.com/YINI-lang/YINI-spec/tree/release#-summary-difference-with-other-formats)  
-  *How does YINI differ: comparison with INI, YAML, and JSON.*
-  
-- ➡️ [Why YINI? (Project Rationale)](https://github.com/YINI-lang/YINI-spec/blob/release/RATIONALE.md)  
-  *Learn about the motivations and design decisions behind YINI.*
-
 - ➡️ [YINI Project](https://github.com/YINI-lang)  
-  *YINI home.*
+  *YINI home on GitHub.*
+
+- ➡️ [YINI Homepage](https://yini-lang.org)  
+  *Tutorials & Docs.*
 
 ---
 
@@ -373,6 +260,6 @@ In this project on GitHub, the `libs` directory contains third party software an
 ---
 
 **^YINI ≡**  
-> A simple, structured, and human-friendly configuration format.  
+> An INI-inspired configuration format with clear structure.  
 
-[yini-lang.org](https://yini-lang.org) · [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 on GitHub](https://github.com/YINI-lang)  

package/dist/YINI.d.ts

@@ -23,7 +23,7 @@ export default class YINI {
      * @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'`)
      *   - `'ignore-errors'`       : Continue parsing despite errors; log them and attempt recovery.
-     *   - `'errors'`              : Stop parsing on the first error.
+     *   - `'errors'`              : Stop parsing on the first error (fail-fast).
      *   - `'warnings-and-errors'` : Stop parsing on the first warning **or** error.
      * @param includeMetadata    If `true`, return additional metadata (e.g. warnings, statistics) alongside the parsed object.
      *
@@ -56,7 +56,7 @@ export default class YINI {
      * @param options.failLevel - Preferred bail sensitivity level, controls if and when parsing should stop on problems:
      *   Accepts:
      *     `'ignore-errors'` - Continue despite errors, persist and try to recover.
-     *     `'errors'` - Stop parsing on the first error.
+     *     `'errors'` - Stop parsing on the first error (fail-fast).
      *     `'warnings-and-errors'` - Stop parsing on the first warning or error.
      *   (Type: TPreferredFailLevel; exact behavior is implementation-defined.)
      * @param options.includeDiagnostics - Include diagnostics in the returned metadata.
@@ -111,7 +111,7 @@ export default class YINI {
      * @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'`)
      *   - `'ignore-errors'`       : Continue parsing despite errors; log them and attempt recovery.
-     *   - `'errors'`              : Stop parsing on the first error.
+     *   - `'errors'`              : Stop parsing on the first error (fail-fast).
      *   - `'warnings-and-errors'` : Stop parsing on the first warning **or** error.
      * @param includeMetadata    If `true`, return additional metadata (e.g. warnings, statistics) alongside the parsed object.
      *
@@ -144,7 +144,7 @@ export default class YINI {
      * @param options.failLevel - Preferred bail sensitivity level, controls if and when parsing should stop on problems:
      *   Accepts:
      *     `'ignore-errors'` - Continue despite errors, persist and try to recover.
-     *     `'errors'` - Stop parsing on the first error.
+     *     `'errors'` - Stop parsing on the first error (fail-fast).
      *     `'warnings-and-errors'` - Stop parsing on the first warning or error.
      *   (Type: TPreferredFailLevel; exact behavior is implementation-defined.)
      * @param options.includeDiagnostics - Include diagnostics in the returned metadata.

package/dist/YINI.js

@@ -6,15 +6,6 @@ const optionsFunctions_1 = require("./core/options/optionsFunctions");
 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).
-// let _runtimeInfo: IRuntimeInfo = {
-//     sourceType: 'Inline',
-//     fileName: undefined,
-//     fileByteSize: null,
-//     lineCount: null,
-//     timeIoMs: null,
-//     preferredBailSensitivity: null,
-//     sha256: null,
-// }
 /**
  * This class is the public API, which exposes only parse(..) and
  * parseFile(..), rest of the implementation details are hidden.
@@ -44,59 +35,8 @@ class YINI {
     static parse(yiniContent, arg2, // strictMode | options
     failLevel = 'auto', includeMetadata = false) {
         (0, print_1.debugPrint)('-> Entered static parse(..) in class YINI\n');
-        // // Runtime guard to catch illegal/ambiguous calls coming from JS or any-cast code
-        // if (
-        //     isOptionsObjectForm(arg2) &&
-        //     (failLevel !== 'auto' || includeMetadata !== false)
-        // ) {
-        //     throw new TypeError(
-        //         'Invalid call: when providing an options object, do not also pass positional parameters.',
-        //     )
-        // }
-        // const mode: TParserMode = inferModeFromArgs(arg2)
-        // const defaultOptions = getDefaultOptions(mode)
-        // // Normalize to a fully-required options object.
-        // let userOpts: Required<ParseOptions>
-        // // Required, makes all properties in T required, no undefined.
-        // if (isOptionsObjectForm(arg2)) {
-        //     userOpts = {
-        //         ...defaultOptions, // Sets the default options.
-        //         ...arg2,
-        //     }
-        // } else {
-        //     // Positional form.
-        //     userOpts = {
-        //         ...defaultOptions, // Sets the default options.
-        //         strictMode:
-        //             (arg2 as boolean | undefined) ?? defaultOptions.strictMode,
-        //         failLevel,
-        //         includeMetadata,
-        //     }
-        // }
-        // if (userOpts.includeMetadata && _runtimeInfo.sourceType === 'Inline') {
-        //     const lineCount = yiniContent.split(/\r?\n/).length // Counts the lines.
-        //     const sha256 = computeSha256(yiniContent) // NOTE: Compute BEFORE any possible tampering of content.
-        //     _runtimeInfo.lineCount = lineCount
-        //     _runtimeInfo.preferredBailSensitivity = userOpts.failLevel
-        //     _runtimeInfo.sha256 = sha256
-        // }
-        // // NOTE: Important: Do not trim or mutate the yiniContent here, due
-        // // to it will mess up the line numbers in error reporting.
-        // if (!yiniContent) {
-        //     throw new Error('Syntax-Error: Unexpected blank YINI input')
-        // }
-        // if (!yiniContent.endsWith('\n')) {
-        //     yiniContent += '\n'
-        // }
-        // let level: TBailSensitivityLevel = mapFailLevelToBail(
-        //     userOpts.strictMode,
-        //     userOpts.failLevel,
-        // )
-        ////////////////
-        // const coreOpts: IParseCoreOptions = toCoreOptions(userOpts,level)
         (0, print_1.debugPrint)();
         (0, print_1.debugPrint)('==== Call runParse(..) in runtime ==========================');
-        // const result = _parseMain(yiniContent, coreOpts, _runtimeInfo)
         const runtime = new runtime_1.YiniRuntime('Inline');
         const result = (0, optionsFunctions_1.isOptionsObjectForm)(arg2)
             ? runtime.runParse(yiniContent, arg2) // Overload #2: (content, options)
@@ -120,68 +60,8 @@ class YINI {
     failLevel = 'auto', includeMetadata = false) {
         (0, print_1.debugPrint)('-> Entered static parseFile(..) in class YINI\n');
         (0, print_1.debugPrint)('Current directory = ' + process.cwd());
-        // // Runtime guard to catch illegal/ambiguous calls coming from JS or any-cast code
-        // if (
-        //     isOptionsObjectForm(arg2) &&
-        //     (failLevel !== 'auto' || includeMetadata !== false)
-        // ) {
-        //     throw new TypeError(
-        //         'Invalid call: when providing an options object, do not also pass positional parameters.',
-        //     )
-        // }
-        // const mode: TParserMode = inferModeFromArgs(arg2)
-        // const defaultOptions = getDefaultOptions(mode)
-        // // Normalize to a fully-required options object.
-        // let userOpts: Required<ParseOptions>
-        // // Required, makes all properties in T required, no undefined.
-        // if (isOptionsObjectForm(arg2)) {
-        //     // Options-object Form.
-        //     userOpts = {
-        //         ...defaultOptions, // Sets the default options.
-        //         ...arg2,
-        //     }
-        // } else {
-        //     // Positional form.
-        //     userOpts = {
-        //         ...defaultOptions, // Sets the default options.
-        //         strictMode:
-        //             (arg2 as boolean | undefined) ?? defaultOptions.strictMode,
-        //         failLevel,
-        //         includeMetadata,
-        //     }
-        // }
-        // if (getFileNameExtension(filePath).toLowerCase() !== '.yini') {
-        //     console.error('Invalid file extension for YINI file:')
-        //     console.error(`"${filePath}"`)
-        //     console.log(
-        //         'File does not have a valid ".yini" extension (case-insensitive).',
-        //     )
-        //     throw new Error('Error: Unexpected file extension for YINI file')
-        // }
-        // // ---- Phase 0: I/O ----
-        // const timeStartMs = performance.now()
-        // // let content = fs.readFileSync(filePath, 'utf8')
-        // const rawBuffer = fs.readFileSync(filePath) // Raw buffer for size.
-        // const fileByteSize = rawBuffer.byteLength // Byte size in UTF-8.
-        // let content = rawBuffer.toString('utf8')
-        // const timeEndMs = performance.now()
-        // _runtimeInfo.sourceType = 'File'
-        // _runtimeInfo.fileName = filePath
-        // if (userOpts.includeMetadata) {
-        //     _runtimeInfo.lineCount = content.split(/\r?\n/).length // Counts the lines.
-        //     _runtimeInfo.fileByteSize = fileByteSize
-        //     _runtimeInfo.timeIoMs = +(timeEndMs - timeStartMs).toFixed(3)
-        //     _runtimeInfo.preferredBailSensitivity = userOpts.failLevel
-        //     _runtimeInfo.sha256 = computeSha256(content) // NOTE: Compute BEFORE any possible tampering of content.
-        // }
-        // let hasNoNewlineAtEOF = false
-        // if (!content.endsWith('\n')) {
-        //     content += '\n'
-        //     hasNoNewlineAtEOF = true
-        // }
         (0, print_1.debugPrint)();
         (0, print_1.debugPrint)('==== Call doParseFile(..) in runtime ==========================');
-        // const result = _parseMain(yiniContent, coreOpts, _runtimeInfo)
         const runtime = new runtime_1.YiniRuntime('File');
         const result = (0, optionsFunctions_1.isOptionsObjectForm)(arg2)
             ? runtime.doParseFile(filePath, arg2) // Overload #2: (content, options)

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

@@ -30,6 +30,8 @@ export default class ASTBuilder<Result> extends YiniParserVisitor<Result> {
     constructor(errorHandler: ErrorDataHandler, options: IParseCoreOptions, sourceType: TSourceType, metaFileName: string | null);
     private hasDefinedSectionTitle;
     private setDefineSectionTitle;
+    private extractStringParts;
+    private extractStringKindAndValue;
     /** Attach a section to the stack respecting up/down moves (Spec 5.3). :contentReference[oaicite:7]{index=7} */
     private attachSection;
     /** Insert a key/value into current section (duplicate handling per options). */