@xaendar/common 0.9.3 → 0.9.4

package/dist/xaendar-common.es.d.ts

@@ -24,6 +24,28 @@ export declare function indent(lines: string[]): string[];
  */
 export declare function isValidCustomElementName(tagName: string): boolean;
 
+/**
+ * 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"
+ */
 export declare function slice(value: string, start?: number, end?: number): string;
 
 /**

package/dist/xaendar-common.es.js

@@ -51,6 +51,28 @@ function indent(lines) {
 }
 //#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)));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaendar/common",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "description": "A library containing common classes and utilities",
   "sideEffects": false,
   "type": "module",