yini-parser 1.0.1-beta → 1.1.0-beta

package/dist/parsers/parseNumber.js

@@ -1,49 +1,83 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const number_1 = require("../utils/number");
 const print_1 = require("../utils/print");
+/**
+ * @property {string | undefined} [tag]
+ *           This parameter is for debugging only. Its
+ *           contents may change at any time and should not
+ *           be relied upon for any significant purpose.
+ */
 const parseNumberLiteral = (txt) => {
     (0, print_1.debugPrint)('-> Entered parseNumberLiteral(..), txt: ' + txt);
-    if (/^0[xX]|#/.test(txt)) {
+    if (/^[+-]?(?:\d+\.\d*|\d*\.?\d+)e[+-]?\d+$/i.test(txt)) {
+        // Exp. numbers
+        (0, print_1.debugPrint)('* Identified as an exp number');
+        return {
+            tag: 'From exp number, Number-Float',
+            // value: parseInt(txt.replace('#', '0x'), 16),
+            value: parseFloat(txt),
+        };
+    }
+    // --- Hexadecimal ---------
+    if (/^[+-]?(0[xX]|#)/.test(txt)) {
         // Prefix: 0x, 0X, #
         (0, print_1.debugPrint)('* Identified as a hex number');
+        (0, print_1.debugPrint)('parsed out HEX: ' + txt.replace(/0[xX]|#/, ''));
         return {
-            type: 'Number-Integer',
+            tag: 'From hex number, Number-Integer',
             // value: parseInt(txt.replace('#', '0x'), 16),
-            value: parseInt(txt.replace(/^0[xX]|#/, ''), 16),
+            value: parseInt(txt.replace(/0[xX]|#/, ''), 16),
         };
     }
-    if (/^0[bB]|%/.test(txt)) {
+    // --- Binary ---------
+    if (/^[+-]?(0[bB]|%)/.test(txt)) {
         // Prefix: 0b, 0B, %
         (0, print_1.debugPrint)('* Identified as a bin number');
+        (0, print_1.debugPrint)('parsed out BIN: ' + txt.replace(/0[bB]|%/, ''));
         return {
-            type: 'Number-Integer',
-            value: parseInt(txt.replace(/^0[bB]|%/, ''), 2),
+            tag: 'From bin number, Number-Integer',
+            value: parseInt(txt.replace(/0[bB]|%/, ''), 2),
         };
     }
-    if (/^0[oO]/.test(txt)) {
+    // --- Octal ---------
+    if (/^[+-]?0[oO]/.test(txt)) {
         // Prefix: 0o, 0O
-        (0, print_1.debugPrint)('* Identified as a ord number');
+        (0, print_1.debugPrint)('* Identified as a oct number');
+        (0, print_1.debugPrint)('parsed out OCT: ' + txt.replace(/0[oO]/, ''));
         return {
-            type: 'Number-Integer',
-            value: parseInt(txt.replace(/^0[oO]/, ''), 8),
+            tag: 'From oct number, Number-Integer',
+            value: parseInt(txt.replace(/0[oO]/, ''), 8),
         };
     }
-    if (/^0[zZ]/.test(txt)) {
-        // Prefix: 0z, 0Z
+    // --- Duodecimal ---------
+    if (/^[+-]?0[zZ]/.test(txt)) {
+        // Prefix: 0z, 0Z, x = A = 10, e = B = 11.
         (0, print_1.debugPrint)('* Identified as a duodecimal number');
+        (0, print_1.debugPrint)('parsed out DOZ: ' + txt.replace(/0[zZ]/, ''));
+        txt = txt.replace(/[xX]/g, 'A');
+        txt = txt.replace(/[eE]/g, 'B');
+        (0, print_1.debugPrint)('Converter to AB form: ' + txt.replace(/0[zZ]/, ''));
         return {
-            type: 'Number-Integer',
-            value: parseInt(txt.replace(/^0[zZ]/, ''), 12),
+            tag: 'From doz (duodecimal) number, Number-Integer',
+            value: parseInt(txt.replace(/0[zZ]/, ''), 12),
         };
     }
     // In a regex literal the dot must be escaped (\.) to match a literal '.'
     if (/\./.test(txt)) {
         (0, print_1.debugPrint)('* Identified as a float number');
-        return { type: 'Number-Float', value: parseFloat(txt) };
+        return {
+            tag: 'From float number, Number-Float',
+            value: parseFloat(txt),
+        };
     }
     // TODO: Depending, on mode, below continue or break on error
     //console.error('Error: Failed to parse number value: ' + txt)
+    if (!(0, number_1.isValidJSNumber)(txt)) {
+        (0, print_1.debugPrint)('* Identified as invalid number');
+        return { tag: 'From invalid number/value', value: undefined };
+    }
     (0, print_1.debugPrint)('* Identified as a int number');
-    return { type: 'Number-Integer', value: parseInt(txt) };
+    return { tag: 'From int number, Number-Integer', value: parseInt(txt) };
 };
 exports.default = parseNumberLiteral;

package/dist/parsers/parseSectionHeader.d.ts

@@ -1,11 +1,12 @@
 import { ErrorDataHandler } from '../core/ErrorDataHandler';
 import { TSectionHeaderType } from '../core/types';
-import { SectionContext } from '../grammar/YiniParser';
+import { StmtContext } from '../grammar/YiniParser';
 /**
  * Extract ...
  * @param rawLine Raw line with the section header.
+ * @note Implemented without regexp to keep it less cryptic, etc.
  */
-declare const parseSectionHeader: (rawLine: string, errorHandler: ErrorDataHandler, ctx: null | SectionContext) => {
+declare const parseSectionHeader: (rawLine: string, errorHandler: ErrorDataHandler, ctx: null | StmtContext) => {
     markerType: TSectionHeaderType;
     sectionName: string;
     sectionLevel: number;

package/dist/parsers/parseSectionHeader.js

@@ -11,6 +11,7 @@ const yiniHelpers_1 = require("../yiniHelpers");
 /**
  * Extract ...
  * @param rawLine Raw line with the section header.
+ * @note Implemented without regexp to keep it less cryptic, etc.
  */
 const parseSectionHeader = (rawLine, errorHandler, ctx) => {
     (0, print_1.debugPrint)('-> Entered parseSectionHeader(..)');

package/dist/utils/number.d.ts

@@ -0,0 +1,3 @@
+export declare const isNaNValue: (n: number) => boolean;
+export declare const isInfinityValue: (n: number) => boolean;
+export declare const isValidJSNumber: (str: string) => boolean;

package/dist/utils/number.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidJSNumber = exports.isInfinityValue = exports.isNaNValue = void 0;
+const isNaNValue = (n) => {
+    return Number.isNaN(n);
+};
+exports.isNaNValue = isNaNValue;
+const isInfinityValue = (n) => {
+    return n === Infinity || n === -Infinity;
+};
+exports.isInfinityValue = isInfinityValue;
+const isValidJSNumber = (str) => {
+    if (str.trim() === '')
+        return false; // Reject empty or whitespace-only.
+    const n = Number(str);
+    return !Number.isNaN(n); // True only if parse succeeded.
+};
+exports.isValidJSNumber = isValidJSNumber;

package/dist/utils/object.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Removes top-level properties with value `undefined`.
+ * Does not recurse into nested objects or arrays.
+ *
+ * @param obj Any JS object
+ * @returns A shallow copy with undefined properties removed,
+ *          except in nested objects or arrays.
+ *
+ * @example
+ * Input:
+ * const input = {
+ *     a: 1,
+ *     b: undefined,
+ *     c: { d: undefined, e: 2 },
+ *     f: [1, undefined, 2]
+ * };
+ *
+ * Output:
+ *   {
+ *     a: 1,
+ *     c: { d: undefined, e: 2 },
+ *     f: [1, undefined, 2]
+ *   }
+ */
+export declare const removeUndefinedShallow: <T extends object>(obj: T) => Partial<T>;
+/**
+ * Recursively removes properties with value `undefined` from objects
+ * and arrays.
+ *
+ * @param obj Any JS value (object, array, primitive)
+ * @returns A deep-cloned copy with all `undefined` removed, including in
+ *          nested objects and arrays.
+ *
+ * @example
+ * Input:
+ *   const input = {
+ *       a: 1,
+ *       b: undefined,
+ *       c: {
+ *           d: undefined,
+ *           e: 2,
+ *           f: [1, undefined, { g: undefined, h: 42 }]
+ *       }
+ *   };
+ *
+ * Output:
+ *   {
+ *     a: 1,
+ *     c: {
+ *         e: 2,
+ *         f: [1, { h: 42 }]
+ *     }
+ *   }
+ */
+export declare const removeUndefinedDeep: <T>(obj: T) => T;

package/dist/utils/object.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeUndefinedDeep = exports.removeUndefinedShallow = void 0;
+/**
+ * Removes top-level properties with value `undefined`.
+ * Does not recurse into nested objects or arrays.
+ *
+ * @param obj Any JS object
+ * @returns A shallow copy with undefined properties removed,
+ *          except in nested objects or arrays.
+ *
+ * @example
+ * Input:
+ * const input = {
+ *     a: 1,
+ *     b: undefined,
+ *     c: { d: undefined, e: 2 },
+ *     f: [1, undefined, 2]
+ * };
+ *
+ * Output:
+ *   {
+ *     a: 1,
+ *     c: { d: undefined, e: 2 },
+ *     f: [1, undefined, 2]
+ *   }
+ */
+const removeUndefinedShallow = (obj) => {
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined) {
+            cleaned[key] = value;
+        }
+    }
+    return cleaned;
+};
+exports.removeUndefinedShallow = removeUndefinedShallow;
+/**
+ * Recursively removes properties with value `undefined` from objects
+ * and arrays.
+ *
+ * @param obj Any JS value (object, array, primitive)
+ * @returns A deep-cloned copy with all `undefined` removed, including in
+ *          nested objects and arrays.
+ *
+ * @example
+ * Input:
+ *   const input = {
+ *       a: 1,
+ *       b: undefined,
+ *       c: {
+ *           d: undefined,
+ *           e: 2,
+ *           f: [1, undefined, { g: undefined, h: 42 }]
+ *       }
+ *   };
+ *
+ * Output:
+ *   {
+ *     a: 1,
+ *     c: {
+ *         e: 2,
+ *         f: [1, { h: 42 }]
+ *     }
+ *   }
+ */
+const removeUndefinedDeep = (obj) => {
+    if (obj === null || typeof obj !== 'object') {
+        return obj; // primitive value
+    }
+    if (Array.isArray(obj)) {
+        // Clean each element, and filter out undefined entries
+        return obj
+            .map((item) => (0, exports.removeUndefinedDeep)(item))
+            .filter((item) => item !== undefined);
+    }
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined) {
+            cleaned[key] = (0, exports.removeUndefinedDeep)(value);
+        }
+    }
+    return cleaned;
+};
+exports.removeUndefinedDeep = removeUndefinedDeep;

package/dist/utils/string.d.ts

@@ -2,12 +2,27 @@
  * This file contains general string helper functions (utils).
  * @note More specific YINI helper functions should go into yiniHelpers.ts-file.
  */
+/**
+ * Capitalizes the first character of a string.
+ *
+ * @param str The input string.
+ * @returns A new string with the first character uppercased.
+ */
+export declare const capitalizeFirst: (str: string) => string;
+export declare const computeSha256: (content: string) => string;
 /**
  * Splits a string into an array of lines, handling both LF and CRLF newlines.
  * @param content The input string.
  * @returns Array of lines (strings).
  */
-export declare function splitLines(content: string): string[];
+export declare const splitLines: (content: string) => string[];
+/**
+ * Trims trailing non-letter characters (A–Z, a–z) from the end of a string.
+ *
+ * @param str Input string
+ * @returns String with trailing non-letters removed
+ */
+export declare const trimTrailingNonLetters: (str: string) => string;
 /**
  * If a string starts and ends with a backtick `, if so trims the
  * first and last character (the backticks).
@@ -40,3 +55,8 @@ export declare const isDigit: (character: string) => boolean;
  * @deprecated This seems not useful anymore, use stripCommentsAndAfter(..) instead.
  */
 export declare const stripNLAndAfter: (line: string) => string;
+/**
+ * Transforms strings such as 'Id-Name' to 'id_name'.
+ * Replaces all '-' to '_', and returns rusult in lower case.
+ */
+export declare const toLowerSnakeCase: (txt: string) => string;

package/dist/utils/string.js

@@ -4,18 +4,45 @@
  * @note More specific YINI helper functions should go into yiniHelpers.ts-file.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stripNLAndAfter = exports.isDigit = exports.isAlpha = exports.isEnclosedInBackticks = exports.trimBackticks = void 0;
-exports.splitLines = splitLines;
+exports.toLowerSnakeCase = exports.stripNLAndAfter = exports.isDigit = exports.isAlpha = exports.isEnclosedInBackticks = exports.trimBackticks = exports.trimTrailingNonLetters = exports.splitLines = exports.computeSha256 = exports.capitalizeFirst = void 0;
+const crypto_1 = require("crypto");
 const print_1 = require("./print");
+/**
+ * Capitalizes the first character of a string.
+ *
+ * @param str The input string.
+ * @returns A new string with the first character uppercased.
+ */
+const capitalizeFirst = (str) => {
+    if (!str)
+        return str;
+    return str.charAt(0).toUpperCase() + str.slice(1);
+};
+exports.capitalizeFirst = capitalizeFirst;
+const computeSha256 = (content) => {
+    return (0, crypto_1.createHash)('sha256').update(content, 'utf8').digest('hex');
+};
+exports.computeSha256 = computeSha256;
 /**
  * Splits a string into an array of lines, handling both LF and CRLF newlines.
  * @param content The input string.
  * @returns Array of lines (strings).
  */
-function splitLines(content) {
+const splitLines = (content) => {
     // Chould handle \n (LF), \r\n (CRLF), and even just \r (old Mac style).
     return content.split(/\r\n|\r|\n/);
-}
+};
+exports.splitLines = splitLines;
+/**
+ * Trims trailing non-letter characters (A–Z, a–z) from the end of a string.
+ *
+ * @param str Input string
+ * @returns String with trailing non-letters removed
+ */
+const trimTrailingNonLetters = (str) => {
+    return str.replace(/[^a-zA-Z]+$/g, '');
+};
+exports.trimTrailingNonLetters = trimTrailingNonLetters;
 /**
  * If a string starts and ends with a backtick `, if so trims the
  * first and last character (the backticks).
@@ -95,3 +122,11 @@ const stripNLAndAfter = (line) => {
     return resultLine;
 };
 exports.stripNLAndAfter = stripNLAndAfter;
+/**
+ * Transforms strings such as 'Id-Name' to 'id_name'.
+ * Replaces all '-' to '_', and returns rusult in lower case.
+ */
+const toLowerSnakeCase = (txt) => {
+    return txt.trim().toLowerCase().replace(/[-]/g, '_');
+};
+exports.toLowerSnakeCase = toLowerSnakeCase;

package/dist/utils/system.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Error instance helper.
+ * @example
+ *   ...
+ *   } catch (err: unknown) {
+ *       if (err instanceof Error) {
+ *           console.error("Message:", err.message)
+ *           console.error("Stack:", err.stack)
+ *       } else {
+ *           console.error("Unknown error:", err)
+ *           console.error("Thrown value:", JSON.stringify(err))
+ *       }
+ *   }
+ */
+export declare const isError: (e: unknown) => e is Error;

package/dist/utils/system.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isError = void 0;
+/**
+ * Error instance helper.
+ * @example
+ *   ...
+ *   } catch (err: unknown) {
+ *       if (err instanceof Error) {
+ *           console.error("Message:", err.message)
+ *           console.error("Stack:", err.stack)
+ *       } else {
+ *           console.error("Unknown error:", err)
+ *           console.error("Thrown value:", JSON.stringify(err))
+ *       }
+ *   }
+ */
+const isError = (e) => {
+    return e instanceof Error;
+};
+exports.isError = isError;

package/dist/yiniHelpers.d.ts

@@ -2,6 +2,7 @@
  * This file contains specific YINI helper functions (utils).
  * @note More general helper functions should go into the dir "src/utils/".
  */
+import { TScalarValue, TValueLiteral } from './core/types';
 /**
  * Check if the character is a section marker character.
  * @param character A character in a string.
@@ -42,3 +43,5 @@ export declare const isValidSimpleIdent: (str: string) => boolean;
  * @link https://github.com/YINI-lang/YINI-spec/blob/develop/YINI-Specification.md#34-identifiers
  */
 export declare const isValidBacktickedIdent: (str: string) => boolean;
+export declare const printLiteral: (value: TValueLiteral) => void;
+export declare const isScalar: (v: TValueLiteral) => v is TScalarValue;

package/dist/yiniHelpers.js

@@ -4,7 +4,7 @@
  * @note More general helper functions should go into the dir "src/utils/".
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidBacktickedIdent = exports.isValidSimpleIdent = exports.stripCommentsAndAfter = exports.isMarkerCharacter = void 0;
+exports.isScalar = exports.printLiteral = exports.isValidBacktickedIdent = exports.isValidSimpleIdent = exports.stripCommentsAndAfter = exports.isMarkerCharacter = void 0;
 const print_1 = require("./utils/print");
 const string_1 = require("./utils/string");
 const SECTION_MARKER1 = '^';
@@ -37,11 +37,14 @@ exports.isMarkerCharacter = isMarkerCharacter;
  * @throws Will throw if consisting more than 1 lines.
  */
 const stripCommentsAndAfter = (line) => {
-    if ((0, string_1.splitLines)(line).length > 1) {
-        throw new Error('Internal error: Detected several row lines in line: >>>' +
-            line +
-            '<<<');
-    }
+    // if (splitLines(line).length > 1) {
+    //     throw new Error(
+    //         'Internal error: Detected several row lines in line: >>>' +
+    //             line +
+    //             '<<<',
+    //     )
+    // }
+    line = line.split('\n', 1)[0];
     let idx1 = line.indexOf('//');
     let idx2 = line.indexOf('# '); // NOTE: (!) Hash comments requires a WS after the hash!
     let idx3 = line.indexOf('#\t'); // NOTE: (!) Hash comments requires a WS after the hash!
@@ -66,7 +69,7 @@ const stripCommentsAndAfter = (line) => {
     const resultLine = idx === Number.MAX_SAFE_INTEGER ? line : line.substring(0, idx);
     (0, print_1.debugPrint)('stripCommentsAndAfter(..),       line: >>>' + line + '<<<');
     (0, print_1.debugPrint)('stripCommentsAndAfter(..), resultLine: >>>' + resultLine + '<<<');
-    return resultLine;
+    return resultLine.trim();
 };
 exports.stripCommentsAndAfter = stripCommentsAndAfter;
 /**
@@ -139,3 +142,36 @@ const isValidBacktickedIdent = (str) => {
     return true;
 };
 exports.isValidBacktickedIdent = isValidBacktickedIdent;
+const assertNever = (x) => {
+    throw new Error(`Unhandled: ${JSON.stringify(x)}`);
+};
+const printLiteral = (value) => {
+    switch (value.type) {
+        case 'String':
+        case 'Number':
+        case 'Boolean':
+        case 'Null':
+            console.log('' + value.value);
+            break;
+        case 'Undefined':
+            console.log('' + value.value);
+            break;
+        case 'List':
+            (0, print_1.printObject)(value.elems);
+            break;
+        case 'Object':
+            (0, print_1.printObject)(value.entries);
+            break;
+        default:
+            return assertNever(value); // ensures exhaustiveness
+    }
+};
+exports.printLiteral = printLiteral;
+const isScalar = (v) => v.type === 'String' ||
+    v.type === 'Number' ||
+    v.type === 'Boolean' ||
+    v.type === 'Null';
+exports.isScalar = isScalar;
+// export const isList = (v: TValueLiteral): v is TListValue => v.type === 'List'
+// export const isObject = (v: TValueLiteral): v is TObjectValue =>
+//     v.type === 'Object'

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "yini-parser",
-    "version": "1.0.1-beta",
-    "description": "Simple and flexible config parser for Node.js. YINI: an enhanced, readable alternative to JSON, INI, and YAML—built for modern JavaScript and TypeScript projects.",
+    "version": "1.1.0-beta",
+    "description": "Node.js parser for YINI — a clean, structured INI alternative with types, simple section nesting, comments, and strict mode.",
     "keywords": [
         "yini",
         "yini-parser",
@@ -19,7 +19,7 @@
         "nodejs",
         "javascript"
     ],
-    "homepage": "https://m4se.com/yini-lang.org/",
+    "homepage": "https://github.com/YINI-lang/yini-parser-typescript",
     "license": "Apache-2.0",
     "files": [
         "dist/",