@xaendar/common 0.9.18 → 0.9.22

package/dist/xaendar-common.js

@@ -0,0 +1,154 @@
+(function(global, factory) {
+	typeof exports === "object" && typeof module !== "undefined" ? factory(exports) : typeof define === "function" && define.amd ? define(["exports"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global["@xaendar/common"] = {}));
+})(this, function(exports) {
+	Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+	//#region ../packages/common/src/models/stack/stack.model.ts
+	/**
+	* A generic LIFO (Last In, First Out) stack data structure.
+	*
+	* @template T - The type of elements held in the stack. Defaults to `unknown`.
+	*/
+	var Stack = class {
+		/**
+		* Internal array holding the stack elements, ordered from bottom to top.
+		*/
+		_elements = new Array();
+		constructor() {
+			return new Proxy(this, { get(target, prop) {
+				return isNaN(Number(prop)) ? target[prop] : target._elements[Number(prop)];
+			} });
+		}
+		/**
+		* The number of elements currently in the stack.
+		*/
+		get length() {
+			return this._elements.length;
+		}
+		/**
+		* A shallow copy of the elements in the stack, ordered from bottom to top.
+		*/
+		get values() {
+			return [...this._elements];
+		}
+		/**
+		* Removes and returns the top element of the stack.
+		*
+		* @returns The top element, or `undefined` if the stack is empty.
+		*/
+		pop() {
+			return this._elements.pop();
+		}
+		/**
+		* Pushes an element onto the top of the stack.
+		*
+		* @param element - The element to push.
+		* @returns The new length of the stack.
+		*/
+		push(element) {
+			return this._elements.push(element);
+		}
+	};
+	//#endregion
+	//#region ../packages/common/src/utils/indent/indent.utils.ts
+	function indent(lines) {
+		return typeof lines === "string" ? `  ${lines}` : lines.map((line) => `  ${line}`);
+	}
+	//#endregion
+	//#region ../packages/common/src/utils/string/string.utils.ts
+	/**
+	* Returns a substring of `value`, copying the result via JSON
+	* serialization (to obtain a "clean" new string instance).
+	* 
+	* This method ensure to resolve a note V8 Engine's problem 
+	* about Sliced String and how they are hard to be garbage collectable
+	* and can lead to preserve a indefinite number of closure occupying
+	* unnecessary memory
+	* https://stackoverflow.com/questions/79478418/how-to-correctly-unref-a-v8-substring-sliced-string-from-its-source-string
+	*
+	* @param value - The source string to extract the substring from.
+	* @param start - The zero-based index at which to start extraction. If omitted, starts from the beginning of the string.
+	*                If negative, it is treated as `value.length + start`.
+	* @param end - The zero-based index at which to end extraction (exclusive). If omitted, extraction goes to the end of the string.
+	*              If negative, it is treated as `value.length + end`.
+	* @returns The substring extracted from `value` between `start` and `end`.
+	*
+	* @example
+	* slice("Hello world", 0, 5); // "Hello"
+	* slice("Hello world", 6);    // "world"
+	* slice("Hello world", -5);   // "world"
+	*/
+	function slice(value, start, end) {
+		return JSON.parse(JSON.stringify(value.slice(start, end)));
+	}
+	//#endregion
+	//#region ../packages/common/src/costants/not-alllowed-tags.constants.ts
+	/**
+	* Tag names that are reserved by the HTML/SVG specifications and cannot be
+	* used as custom element names.
+	*
+	* @see https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name
+	*/
+	var NOT_ALLOWED_TAGS = [
+		"annotation-xml",
+		"color-profile",
+		"font-face",
+		"font-face-src",
+		"font-face-uri",
+		"font-face-format",
+		"font-face-name",
+		"missing-glyph"
+	];
+	//#endregion
+	//#region ../packages/common/src/utils/tags/tags.utils.ts
+	/**
+	* Asserts that a given tag name is valid for use as a custom element name.
+	* A valid custom element name must:
+	* - contain a hyphen
+	* - no spaces.
+	* - start with a lowercase letter.
+	* - not contain uppercase letters.
+	* - not contain the following chars: '@', '#', '$', '%', '&', '*', '!', '?', '/', '\\', '|', "'", '"', '<', '>', '='
+	* - not be a native HTML tag name.
+	* - not be a reserved tag name.
+	*
+	* @param tagName - The tag name to validate.
+	* @throws Will throw an error if the tag name is invalid.
+	*/
+	function isValidCustomElementName(tagName) {
+		if (!/^[a-z][a-z0-9._\-]*-[a-z0-9._\-]*$/.test(tagName)) {
+			console.error(`Tag <${tagName}> is not a valid custom element name. Custom element names must:
+- contain a hyphen
+- no spaces.
+- start with a lowercase letter.
+- not contain uppercase letters.
+- not be a native HTML tag name.
+- not contain the following chars: '@', '#', '$', '%', '&', '*', '!', '?', '/', '\\', '|', "'", '"', '<', '>', '='
+`);
+			return false;
+		}
+		if (isReservedTagName(tagName)) {
+			console.error(`Tag <${tagName}> is a reserved tag name and cannot be used as a custom element name.
+Reserved names are: 
+- ${NOT_ALLOWED_TAGS.join("\n- ")}`);
+			return false;
+		}
+		return true;
+	}
+	/**
+	* Checks if a tag name is reserved and cannot be used for a custom element.
+	* 
+	* Reserved names include certain HTML, SVG, or other names that are forbidden by the specification.
+	* https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name
+	* 
+	* @param tagName - The tag name to check.
+	* @returns `true` if the tag name is reserved, `false` otherwise.
+	*/
+	function isReservedTagName(tagName) {
+		return NOT_ALLOWED_TAGS.includes(tagName);
+	}
+	//#endregion
+	exports.Stack = Stack;
+	exports.indent = indent;
+	exports.isValidCustomElementName = isValidCustomElementName;
+	exports.slice = slice;
+});

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@xaendar/common",
-  "version": "0.9.18",
+  "version": "0.9.22",
   "description": "A library containing common classes and utilities",
   "sideEffects": false,
   "type": "module",
-  "main": "./dist/xaendar-common.es.js",
-  "module": "./dist/xaendar-common.es.js",
-  "types": "./dist/xaendar-common.es.d.ts",
+  "main": "./dist/xaendar-common.js",
+  "module": "./dist/xaendar-common.js",
+  "types": "./dist/xaendar-common.d.ts",
   "exports": {
     ".": {
       "import": {
-        "types": "./dist/xaendar-common.es.d.ts",
-        "default": "./dist/xaendar-common.es.js"
+        "types": "./dist/xaendar-common.d.ts",
+        "default": "./dist/xaendar-common.js"
       }
     }
   }

package/dist/xaendar-common.es.js

@@ -1,146 +0,0 @@
-//#region ../packages/common/src/models/stack/stack.model.ts
-/**
-* A generic LIFO (Last In, First Out) stack data structure.
-*
-* @template T - The type of elements held in the stack. Defaults to `unknown`.
-*/
-var Stack = class {
-	/**
-	* Internal array holding the stack elements, ordered from bottom to top.
-	*/
-	_elements = new Array();
-	constructor() {
-		return new Proxy(this, { get(target, prop) {
-			return isNaN(Number(prop)) ? target[prop] : target._elements[Number(prop)];
-		} });
-	}
-	/**
-	* The number of elements currently in the stack.
-	*/
-	get length() {
-		return this._elements.length;
-	}
-	/**
-	* A shallow copy of the elements in the stack, ordered from bottom to top.
-	*/
-	get values() {
-		return [...this._elements];
-	}
-	/**
-	* Removes and returns the top element of the stack.
-	*
-	* @returns The top element, or `undefined` if the stack is empty.
-	*/
-	pop() {
-		return this._elements.pop();
-	}
-	/**
-	* Pushes an element onto the top of the stack.
-	*
-	* @param element - The element to push.
-	* @returns The new length of the stack.
-	*/
-	push(element) {
-		return this._elements.push(element);
-	}
-};
-//#endregion
-//#region ../packages/common/src/utils/indent/indent.utils.ts
-function indent(lines) {
-	return typeof lines === "string" ? `  ${lines}` : lines.map((line) => `  ${line}`);
-}
-//#endregion
-//#region ../packages/common/src/utils/string/string.utils.ts
-/**
-* Returns a substring of `value`, copying the result via JSON
-* serialization (to obtain a "clean" new string instance).
-* 
-* This method ensure to resolve a note V8 Engine's problem 
-* about Sliced String and how they are hard to be garbage collectable
-* and can lead to preserve a indefinite number of closure occupying
-* unnecessary memory
-* https://stackoverflow.com/questions/79478418/how-to-correctly-unref-a-v8-substring-sliced-string-from-its-source-string
-*
-* @param value - The source string to extract the substring from.
-* @param start - The zero-based index at which to start extraction. If omitted, starts from the beginning of the string.
-*                If negative, it is treated as `value.length + start`.
-* @param end - The zero-based index at which to end extraction (exclusive). If omitted, extraction goes to the end of the string.
-*              If negative, it is treated as `value.length + end`.
-* @returns The substring extracted from `value` between `start` and `end`.
-*
-* @example
-* slice("Hello world", 0, 5); // "Hello"
-* slice("Hello world", 6);    // "world"
-* slice("Hello world", -5);   // "world"
-*/
-function slice(value, start, end) {
-	return JSON.parse(JSON.stringify(value.slice(start, end)));
-}
-//#endregion
-//#region ../packages/common/src/costants/not-alllowed-tags.constants.ts
-/**
-* Tag names that are reserved by the HTML/SVG specifications and cannot be
-* used as custom element names.
-*
-* @see https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name
-*/
-var NOT_ALLOWED_TAGS = [
-	"annotation-xml",
-	"color-profile",
-	"font-face",
-	"font-face-src",
-	"font-face-uri",
-	"font-face-format",
-	"font-face-name",
-	"missing-glyph"
-];
-//#endregion
-//#region ../packages/common/src/utils/tags/tags.utils.ts
-/**
-* Asserts that a given tag name is valid for use as a custom element name.
-* A valid custom element name must:
-* - contain a hyphen
-* - no spaces.
-* - start with a lowercase letter.
-* - not contain uppercase letters.
-* - not contain the following chars: '@', '#', '$', '%', '&', '*', '!', '?', '/', '\\', '|', "'", '"', '<', '>', '='
-* - not be a native HTML tag name.
-* - not be a reserved tag name.
-*
-* @param tagName - The tag name to validate.
-* @throws Will throw an error if the tag name is invalid.
-*/
-function isValidCustomElementName(tagName) {
-	if (!/^[a-z][a-z0-9._\-]*-[a-z0-9._\-]*$/.test(tagName)) {
-		console.error(`Tag <${tagName}> is not a valid custom element name. Custom element names must:
-- contain a hyphen
-- no spaces.
-- start with a lowercase letter.
-- not contain uppercase letters.
-- not be a native HTML tag name.
-- not contain the following chars: '@', '#', '$', '%', '&', '*', '!', '?', '/', '\\', '|', "'", '"', '<', '>', '='
-`);
-		return false;
-	}
-	if (isReservedTagName(tagName)) {
-		console.error(`Tag <${tagName}> is a reserved tag name and cannot be used as a custom element name.
-Reserved names are: 
-- ${NOT_ALLOWED_TAGS.join("\n- ")}`);
-		return false;
-	}
-	return true;
-}
-/**
-* Checks if a tag name is reserved and cannot be used for a custom element.
-* 
-* Reserved names include certain HTML, SVG, or other names that are forbidden by the specification.
-* https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name
-* 
-* @param tagName - The tag name to check.
-* @returns `true` if the tag name is reserved, `false` otherwise.
-*/
-function isReservedTagName(tagName) {
-	return NOT_ALLOWED_TAGS.includes(tagName);
-}
-//#endregion
-export { Stack, indent, isValidCustomElementName, slice };