affinirum 1.2.5 → 1.2.8

package/README.md

@@ -58,6 +58,7 @@ A function is a callable code unit that produces a value.
 The set of built-in functions can be extended through configuration entries.
 Additionally, subroutines (functions defined in code) can be created.
 
+### Variables
 Valid variable and function names must start with a letter, number sign (**\#**), dollar sign (**\$**), or underscore (**\_**)
  and can be followed by any combination of alphanumeric characters, number signs, dollar signs, or underscores,
  like *x*, *\_a1$*, *abc25*.
@@ -77,7 +78,7 @@ Whitespace characters are ignored.
 - **function** for built-in, injected or script-defined subroutines
 
 Type modifier **?** can be used to make any type optional (nullable).
-<br>Examples: *float? optNumVar*, *array? optArrayVar*
+<br>Examples: *float?*, *array?*
 
 Unknown or variant type is declared as **??**.
 
@@ -129,7 +130,7 @@ Unknown or variant type is declared as **??**.
 - **boolean Boolean.And(values: array...)** — Boolean conjunction
 - **boolean Boolean.Not(value: boolean)** — Boolean negation
 - **boolean? Boolean.Decode(value: buffer, offset: integer?)** — Decode boolean from buffer
-- **boolean? Boolean.ParseBoolean()** — Parse boolean from string
+- **boolean? Boolean.Parse()** — Parse boolean from string
 
 #### Timestamp
 - **timestamp Timestamp.Now()** — Current date and time
@@ -170,7 +171,7 @@ Unknown or variant type is declared as **??**.
 
 #### Buffer
 - **buffer Buffer.Random(length: integer)** — Buffer of given length filled with random bytes
-- **buffer? Buffer.ParseBuffer(value: string)** — Parse buffer from hexadecimal string
+- **buffer? Buffer.Parse(value: string)** — Parse buffer from hexadecimal string
 
 #### Array
 - **array Array.Join(values: array...)** — Join arrays of any depths into a single array

package/dst/Affinirum.d.ts

@@ -54,6 +54,13 @@ export declare class Affinirum {
         @returns Calculated value.
     */
     evaluate(values?: Record<string, Value>): Value;
+    /**
+        Produces string in Affinirum Notation.
+        @param value Value to format.
+        @param whitespace Optional white space characters for readability.
+        @returns String formatted in Affinirum Notation.
+    */
+    static format(value: Value, whitespace?: string): string;
     protected _list(state: ParserState, scope: StaticScope): Node;
     protected _unit(state: ParserState, scope: StaticScope): Node;
     protected _coalescence(state: ParserState, scope: StaticScope): Node;

package/dst/Affinirum.js

@@ -1,3 +1,4 @@
+import { formatAN } from "./constant/notation/AN.js";
 import { funcOr, funcAnd, funcNot } from "./constant/Boolean.js";
 import { funcAdd } from "./constant/Aggregable.js";
 import { funcAt, funcHas } from "./constant/Iterable.js";
@@ -117,6 +118,15 @@ export class Affinirum {
             throw e;
         }
     }
+    /**
+        Produces string in Affinirum Notation.
+        @param value Value to format.
+        @param whitespace Optional white space characters for readability.
+        @returns String formatted in Affinirum Notation.
+    */
+    static format(value, whitespace) {
+        return formatAN(value, whitespace);
+    }
     _list(state, scope) {
         const frame = state.starts();
         const subnodes = [];

package/dst/cjs/Affinirum.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Affinirum = void 0;
+const AN_js_1 = require("./constant/notation/AN.js");
 const Boolean_js_1 = require("./constant/Boolean.js");
 const Aggregable_js_1 = require("./constant/Aggregable.js");
 const Iterable_js_1 = require("./constant/Iterable.js");
@@ -120,6 +121,15 @@ class Affinirum {
             throw e;
         }
     }
+    /**
+        Produces string in Affinirum Notation.
+        @param value Value to format.
+        @param whitespace Optional white space characters for readability.
+        @returns String formatted in Affinirum Notation.
+    */
+    static format(value, whitespace) {
+        return (0, AN_js_1.formatAN)(value, whitespace);
+    }
     _list(state, scope) {
         const frame = state.starts();
         const subnodes = [];

package/dst/cjs/constant/notation/AN.js

@@ -30,12 +30,12 @@ const formatAN = (value, whitespace) => {
     if (Array.isArray(value)) {
         const [prefix, suffix] = whitespace ? ["\n" + whitespace, "\n"] : ["", ""];
         const lines = value.map((i) => `${prefix}${(0, exports.formatAN)(i, whitespace).split("\n").join(prefix)}`);
-        return `[${lines.join(",")}${suffix}]`;
+        return lines.length ? `[${lines.join(",")}${suffix}]` : "[]";
     }
     if (typeof value === "object") {
-        const [prefix, suffix] = whitespace ? ["\n" + whitespace, "\n"] : ["", ""];
-        const lines = Object.entries(value).map(([k, v]) => `${prefix}"${k}":${(0, exports.formatAN)(v, whitespace).split("\n").join(prefix)}`);
-        return `[${lines.join(",")}${suffix}]`;
+        const [prefix, suffix, separator] = whitespace ? ["\n" + whitespace, "\n", ": "] : ["", "", ":"];
+        const lines = Object.entries(value).map(([k, v]) => `${prefix}"${k}"${separator}${(0, exports.formatAN)(v, whitespace).split("\n").join(prefix)}`);
+        return lines.length ? `[${lines.join(",")}${suffix}]` : "[:]";
     }
     return "function";
 };

package/dst/constant/notation/AN.js

@@ -27,12 +27,12 @@ export const formatAN = (value, whitespace) => {
     if (Array.isArray(value)) {
         const [prefix, suffix] = whitespace ? ["\n" + whitespace, "\n"] : ["", ""];
         const lines = value.map((i) => `${prefix}${formatAN(i, whitespace).split("\n").join(prefix)}`);
-        return `[${lines.join(",")}${suffix}]`;
+        return lines.length ? `[${lines.join(",")}${suffix}]` : "[]";
     }
     if (typeof value === "object") {
-        const [prefix, suffix] = whitespace ? ["\n" + whitespace, "\n"] : ["", ""];
-        const lines = Object.entries(value).map(([k, v]) => `${prefix}"${k}":${formatAN(v, whitespace).split("\n").join(prefix)}`);
-        return `[${lines.join(",")}${suffix}]`;
+        const [prefix, suffix, separator] = whitespace ? ["\n" + whitespace, "\n", ": "] : ["", "", ":"];
+        const lines = Object.entries(value).map(([k, v]) => `${prefix}"${k}"${separator}${formatAN(v, whitespace).split("\n").join(prefix)}`);
+        return lines.length ? `[${lines.join(",")}${suffix}]` : "[:]";
     }
     return "function";
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "affinirum",
-	"version": "1.2.5",
+	"version": "1.2.8",
 	"description": "Affinirum Scripting Language",
 	"main": "dst/cjs/index.js",
 	"module": "dst/index.js",
@@ -56,12 +56,12 @@
 	},
 	"dependencies": {},
 	"devDependencies": {
-		"@types/jasmine": "~5.1.15",
+		"@types/jasmine": "~6.0.0",
 		"copyfiles": "~2.4.1",
-		"eslint": "~9.39.2",
-		"jasmine": "~5.13.0",
+		"eslint": "~8.57.0",
+		"jasmine": "~6.0.0",
 		"rimraf": "~6.1.2",
 		"typescript": "~5.9.3",
-		"typescript-eslint": "~8.53.0"
+		"typescript-eslint": "~8.54.0"
 	}
 }