@ygracs/xobj-lib-js 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+#### *v0.2.2*
+
+Release version.
+
+> - updated dependency on `@ygracs/bsfoc-lib-js` module to v0.2.3;
+> - other fixes.
+
 #### *v0.2.1*
 
 Release version.

package/lib/xObj-lib.js

@@ -1,4 +1,4 @@
-// [v0.2.099-20250128]
+// [v0.2.101-20250401]
 
 // === module init block ===
 
@@ -320,6 +320,7 @@ function insertXObjElement(...args) {
 };
 
 /**
+ * @since 0.2.0
  * @function insertXObjElementEx
  * @param {object} obj - some object
  * @param {string} name - some child element
@@ -327,7 +328,6 @@ function insertXObjElement(...args) {
  * @returns {RVAL_emodif}
  * @throws {TypeError} if first param is not an object
  * @throws {TypeError} if second param is empty string or not a string at all
- * @since 0.2.0
  * @description Inserts an element addressed by its key into a given object.
  */
 function insertXObjElementEx(obj, name, opt) {
@@ -350,8 +350,12 @@ function insertXObjElementEx(obj, name, opt) {
     obj[key] = prop = item;
     isSucceed = true;
   } else {
-    const _opt = isPlainObject(opt) ? opt : {};
-    let { force, ripOldies, acceptIfList } = _opt;
+    /** @type {OPT_inselops_L} */
+    let {
+      force,
+      ripOldies,
+      acceptIfList,
+    } = isPlainObject(opt) ? opt : {};
     if (typeof force !== 'boolean') force = false;
     if (typeof ripOldies !== 'boolean') ripOldies = false;
     if (typeof acceptIfList !== 'boolean') acceptIfList = false;
@@ -536,6 +540,7 @@ function deleteXObjAttribute(obj, attr = '', key) {
 };
 
 /**
+ * @since 0.2.0
  * @function renameXObjAttribute
  * @param {object} obj - some object
  * @param {string} attr - some attribute ID
@@ -545,7 +550,6 @@ function deleteXObjAttribute(obj, attr = '', key) {
  * @throws {TypeError} if first param is not an object
  * @throws {TypeError} if second param is not an object
  * @throws {TypeError} if third param is not an object
- * @since 0.2.0
  * @description Renames an attribute addressed by a given name.
  */
 function renameXObjAttribute(obj, attr = '', value = '', key = XOBJ_DEF_ATTR_TNAME) {
@@ -1408,6 +1412,7 @@ function insertXObjEList(...args) {
 };
 
 /**
+ * @since 0.2.0
  * @function insertXObjEListEx
  * @param {object} obj - some object
  * @param {string} name - some child element
@@ -1415,7 +1420,6 @@ function insertXObjEList(...args) {
  * @returns {RVAL_emodif}
  * @throws {TypeError} if first param is not an object
  * @throws {TypeError} if second param is empty string or not a string at all
- * @since 0.2.0
  * @description Inserts a list elements into a given object.
  */
 function insertXObjEListEx(obj, name, opt) {
@@ -1431,8 +1435,11 @@ function insertXObjEListEx(obj, name, opt) {
     err.code = code;
     throw err;
   };
-  const _options = isPlainObject(opt) ? opt : {};
-  let { force, ripOldies } = _options;
+  /** @type {OPT_inselops_S} */
+  let {
+    force,
+    ripOldies,
+  } = isPlainObject(opt) ? opt : {};
   if (typeof force !== 'boolean') force = false;
   if (typeof ripOldies !== 'boolean') ripOldies = false;
   let prop = obj[key];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ygracs/xobj-lib-js",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "A helper library to work with xml-js module",
   "author": "ygracs <cs70th-om@rambler.ru>",
   "license": "MIT",
@@ -19,10 +19,9 @@
   "scripts": {
     "test": "jest",
     "test-xobj": "jest xObj",
-    "test-xobj:c1": "jest xObj-lib.1",
-    "test-xobj:c2": "jest xObj-lib.2",
-    "test-xobj:c3": "jest xObj-lib.3",
-    "test-xobj:c4": "jest xObj-lib.4",
+    "test-xobj:c1": "jest xobj-param",
+    "test-xobj:c2": "jest xobj-attr",
+    "test-xobj:c3": "jest xobj-elements",
     "build-doc-md": "jsdoc2md",
     "build-doc-html": "jsdoc"
   },
@@ -31,7 +30,7 @@
     "#test-dir/*": "./__test__/*"
   },
   "dependencies": {
-    "@ygracs/bsfoc-lib-js": "^0.2.2"
+    "@ygracs/bsfoc-lib-js": "^0.2.3"
   },
   "devDependencies": {
     "jest": "^29.7.0",