@cntwg/html-helper 0.0.23 → 0.0.25

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+#### *v0.0.25*
+
+Pre-release version.
+
+> - update dependency on `@ygracs/bsfoc-lib-js` module to v0.2.3;
+> - add dependency on `@ygracs/lists-lib-js` module;
+> - remove some deprecates (*see docs for details*);
+> - change pattern for an element manipulation functions (*see docs for details*);
+> - change behavior for `loadItems` method of `THtmlStubItemsSet` class in handling `options` parameter (*see docs for details*).
+
+#### *v0.0.24*
+
+Pre-release version.
+
+> - update dependency on `@ygracs/bsfoc-lib-js` module to v0.2.2.
+
 #### *v0.0.23*
 
 Pre-release version.

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019-2024 Yuri Grachev
+Copyright (c) 2019-2025 Yuri Grachev
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/doc/html-ctrls-list.md

@@ -1,6 +1,6 @@
->|***rev.*:**|0.1.22|
+>|***rev.*:**|0.1.23|
 >|:---|---:|
->|date:|2024-11-13|
+>|date:|2025-04-16|
 
 ## Introduction
 
@@ -763,6 +763,8 @@ This class methods loads an items given by `list` in the set and returned quanti
 | `list` | `array`, `object` | --- | an array of entries or a special descriptive object |
 | `options` | `boolean`, `object` | --- | an options |
 
+> \[!] NOTE: *`[since v0.0.25]`* the use of a booleans as an `options` value is deprecated and will be dropped soon.
+
 If the `list` parameter is an `object` that contains the following set of values:
 
 | option name | value type | default value | description |

package/doc/html-helper-lib.md

@@ -1,6 +1,6 @@
->|***rev.*:**|0.1.14|
+>|***rev.*:**|0.1.15|
 >|:---|---:|
->|date:|2024-11-10|
+>|date:|2025-03-29|
 
 ## Introduction
 
@@ -170,7 +170,7 @@ This function enables a given HTML-element.
 | `obj` | `HTMLElement` | --- | some element to be modified |
 
 <a name="activateHTMLElements"></a>
-#### **activateHtmlElements(arg_1\[, arg_2\[, ...arg_N]])** => `void`
+#### **activateHTMLElements(arg_1\[, arg_2\[, ...arg_N]])** => `void`
 
 This function enables all HTML-elements received as a function arguments.
 
@@ -207,8 +207,8 @@ The `options` parameter if sets to `true` force the function to remove all dupli
 
 > Note: Purpose of those functions will be discussed and some may be deprecate and make obsolete or functionality may be altered. So use it with cautions in mind.
 
-<a name="createNewHtmlElement"></a>
-#### **createNewHtmlElement(tagName\[, options])**
+<a name="createNewHTMLElement"></a>
+#### **createNewHTMLElement(tagName\[, options])**
 
 This function helps to simplify the process of creating a new HTML-element. It receives the tag name (`tagName` parameter) and the options as a second parameter:
 

package/index.js

@@ -1,4 +1,4 @@
-// [v0.1.025-20241115]
+// [v0.1.027-20250329]
 
 // === module init block ===
 
@@ -69,7 +69,7 @@ module.exports.readAsTagName = html_helper.readAsTagName;
 module.exports.readAsAttrName = html_helper.readAsAttrName;
 module.exports.readAsAttrValue = html_helper.readAsAttrValue;
 module.exports.valueToElementID = html_helper.valueToElementID;
-module.exports.createNewHtmlElement = html_helper.createNewHtmlElement;
+module.exports.createNewHTMLElement = html_helper.createNewHTMLElement;
 
 module.exports.isHTMLButton = html_bts.isHTMLButton;
 
@@ -85,15 +85,4 @@ module.exports.classes = components;
 
 // deprecated
 module.exports.component = components;
-module.exports.hideHtmlElement = html_helper.hideHtmlElement;
-module.exports.showHtmlElement = html_helper.showHtmlElement;
-module.exports.selectHtmlElement = html_helper.selectHtmlElement;
-module.exports.unselectHtmlElement = html_helper.unselectHtmlElement;
-module.exports.markHtmlElementAsCurrent = html_helper.markHtmlElementAsCurrent;
-module.exports.unmarkCurrentHtmlElement = html_helper.unmarkCurrentHtmlElement;
-module.exports.markHtmlElementAsActive = html_helper.markHtmlElementAsActive;
-module.exports.unmarkActiveHtmlElement = html_helper.unmarkActiveHtmlElement;
-module.exports.lockHtmlElement = html_helper.lockHtmlElement;
-module.exports.unlockHtmlElement = html_helper.unlockHtmlElement;
-module.exports.inactivateHtmlElements = html_helper.inactivateHtmlElements;
-module.exports.activateHtmlElements = html_helper.activateHtmlElements;
+module.exports.createNewHtmlElement = html_helper.createNewHtmlElement;

package/lib/html-ctrls/buttons.js

@@ -1,10 +1,14 @@
-// [v0.1.056-20241119]
+// [v0.1.058-20250416]
 
 // === module init block ===
 
 const {
   isNotEmptyString,
   isPlainObject, valueToArray,
+  //TItemsICollection,
+} = require('@ygracs/bsfoc-lib-js');
+
+const {
   TItemsICollection,
 } = require('@ygracs/bsfoc-lib-js');
 
@@ -78,7 +82,7 @@ function isHTMLButton(obj) {
  * @classdesc This class implements an interface of a buttons set
  */
 class THtmlButtonsSet {
-  /** @property {TItemsICollection} */
+  /** @type {TItemsICollection} */
   #_btnCol;
 
   /**
@@ -103,20 +107,20 @@ class THtmlButtonsSet {
   }
 
   /**
-   * @property {string[]}
+   * Contains a list of an element names
+   * @type {string[]}
    * @readonly
    * @see TItemsICollection.ItemNames
-   * @description Contains a list of an element names
    */
   get ItemNames() {
     return this.#_btnCol.ItemNames;
   }
 
   /**
-   * @property {string[]}
+   * Contains a list of an elements group names
+   * @type {string[]}
    * @readonly
    * @see TItemsICollection.CategoryNames
-   * @description Contains a list of an elements group names
    */
   get GroupNames() {
     return this.#_btnCol.CategoryNames;
@@ -267,9 +271,9 @@ class THtmlButtonsSet {
   }
 
   /**
-   * @returns {function}
+   * Returns a function wich do a validation check.
+   * @type {isHTMLButton}
    * @static
-   * @description Returns a function wich do a validation check.
    */
   static get isHTMLButton() {
     return isHTMLButton;
@@ -282,9 +286,9 @@ class THtmlButtonsSet {
  *            A set provide a three button: <apply>, <reset> and <cancel>.
  */
 class THtmlButtonsControllerARCSet {
-  /** @property {THtmlButtonsSet} */
+  /** @type {THtmlButtonsSet} */
   #_btnSet;
-  /** @property {Map} */
+  /** @type {Map<string, Function>} */
   #_events;
 
   /**

package/lib/html-ctrls/fields.js

@@ -1,4 +1,4 @@
-// [v0.1.017-20241119]
+// [v0.1.019-20250416]
 
 // === module init block ===
 
@@ -9,7 +9,7 @@ const {
 } = require('@ygracs/bsfoc-lib-js');
 
 const {
-  isHTMLElement, createNewHtmlElement,
+  isHTMLElement, createNewHTMLElement,
   valueToIDString, valueToClassList,
   readAsAttrValue,
   showHTMLElement, hideHTMLElement,
@@ -95,19 +95,51 @@ function getLabelPositionID(value) {
  * (* class definitions *)
  */
 
+/**
+ * @typedef {Object} OPT_ifcdesc
+ * @property {object} [host]
+ * @property {string} [idPref]
+ * @property {object} [label]
+ * @property {object} [labelPosition]
+ * @property {boolean} [useDelim]
+ * @property {object} [baseClassID]
+ * @property {string} [hint]
+ * @property {object} [type]
+ * @property {boolean} [readonly] - mode flag
+ * @description An options set for create ifc
+ */
+
+/**
+ * @typedef {Object} OPT_ifcsett
+ * @property {string} [idPref]
+ * @property {(string|string[])} [baseClassID]
+ * @property {string} [hint]
+ * @property {string} [type]
+ * @property {boolean} [readonly=true] - mode flag
+ * @description An options set for `THtmlInputField`-class
+ */
+
+/**
+ * @typedef {Object} ifcElementsDesc
+ * @property {HTMLElement} host - host element
+ * @property {HTMLElement} label - label element
+ * @property {HTMLElement} field - field element
+ * @description A description for input field elements set.
+ */
+
 /**
  * @classdesc This class implements an interface of an input field element
  */
 class THtmlInputField {
-  /** @property {?HTMLElement} */
+  /** @type {?HTMLElement} */
   #_host;// = null;
-  /** @property {?HTMLElement} */
+  /** @type {?HTMLElement} */
   #_label;// = null;
-  /** @property {?HTMLElement} */
+  /** @type {?HTMLElement} */
   #_field;// = null;
   #_id = '';
   #_value = '';
-  /** @property {object} */
+  /** @type {OPT_ifcsett} */
   #_options = null;
   /**
    * @typedef {Object} statIFCtrl
@@ -118,28 +150,15 @@ class THtmlInputField {
    * @inner
    * @description A controller status
    */
-  /** @property {statIFCtrl} */
+  /** @type {statIFCtrl} */
   #_status;// = null;
-  /** @property {Map} */
+  /** @type {Map<string, Function>} */
   #_events;// = null;
 
-  /**
-   * @typedef {Object} ifcElementsDesc
-   * @property {HTMLElement} host - host element
-   * @property {HTMLElement} label - label element
-   * @property {HTMLElement} field - field element
-   * @description A description for input field elements set.
-   */
-
   /**
    * @param {string} name - <*reserved*>
    * @param {ifcElementsDesc} eholds - elements set
-   * @param {object} [opt]
-   * @param {string} [opt.idPref]
-   * @param {(string|string[])} [opt.baseClassID]
-   * @param {string} [opt.hint]
-   * @param {string} [opt.type]
-   * @param {boolean} [opt.readonly=true]
+   * @param {OPT_ifcsett} [opt] - options
    * @description Creates an instance of an input field element
    */
   constructor(name, eholds, opt) {
@@ -185,28 +204,28 @@ class THtmlInputField {
   }
 
   /**
-   * @property {boolean}
+   * Indicates whether element value was modified.
+   * @type {boolean}
    * @readonly
-   * @description Indicates whether element value was modified.
    */
   get isModified() {
     return this.#_status.isModified;
   }
 
   /**
+   * Returns an input element origin type.
    * @since v0.0.23
-   * @property {string}
+   * @type {string}
    * @readonly
-   * @description Returns an input element origin type.
    */
   get type() {
     return this.#_status.fldType;
   }
 
   /**
-   * @property {string}
+   * Containes an element value.
+   * @type {string}
    * @fires THtmlInputField#value-empty
-   * @description Containes an element value.
    */
   get value() {
     const field = this.#_field;
@@ -371,7 +390,7 @@ class THtmlInputField {
 
   /**
    * @param {string} name - <*reserved*>
-   * @param {object} opt
+   * @param {OPT_ifcdesc} opt - options
    * @returns {?THtmlInputField}
    * @static
    * @description Creates a new element.
@@ -388,17 +407,8 @@ class THtmlInputField {
 
   /**
    * @param {string} name
-   * @param {object} [opt]
-   * @param {object} [opt.host]
-   * @param {string} [opt.idPref]
-   * @param {object} [opt.label]
-   * @param {object} [opt.labelPosition]
-   * @param {boolean} [opt.useDelim]
-   * @param {object} [opt.baseClassID]
-   * @param {string} [opt.hint]
-   * @param {object} [opt.type]
-   * @param {boolean} [opt.readonly]
-   * @param {boolean} [doRetChild=false]
+   * @param {OPT_ifcdesc} [opt] - options
+   * @param {boolean} [doRetChild=false] - mode flag
    * @returns {(HTMLElement|ifcElementsDesc)}
    * @static
    * @description Creates a new elements.
@@ -407,6 +417,7 @@ class THtmlInputField {
     const id = valueToIDString(name);
     const _options = isPlainObject(opt) ? opt : {};
     let fldSubType = '';
+    /** @type {OPT_ifcdesc} */
     let {
       host,
       idPref,
@@ -440,7 +451,7 @@ class THtmlInputField {
     isReadOnly = readAsBool(isReadOnly, true);
     let fldID = idPref === '' ? id : `${idPref}-${id}`;
     if (!isHTMLElement(host)) {
-      host = createNewHtmlElement('div', {
+      host = createNewHTMLElement('div', {
         class: bcidHost,
       });
     };
@@ -450,7 +461,7 @@ class THtmlInputField {
     if (host) {
       lblHolder = host.querySelector(`label[for="${fldID}"]`);
       if (!lblHolder) {
-        lblHolder = createNewHtmlElement('label', {
+        lblHolder = createNewHTMLElement('label', {
           text: label,
           attr: {
             for: fldID,
@@ -460,7 +471,7 @@ class THtmlInputField {
       };
       fldHolder = host.querySelector(`input#${fldID}`);
       if (!fldHolder) {
-        fldHolder = createNewHtmlElement('input', {
+        fldHolder = createNewHTMLElement('input', {
           id: fldID,
           attr: {
             type: fldType,

package/lib/html-ctrls/list.js

@@ -1,13 +1,17 @@
-// [v0.1.067-20241119]
+// [v0.1.069-20250416]
 
 // === module init block ===
 
 const {
   readAsNumber,
   isPlainObject,
-  TItemsListEx,
+  //TItemsListEx,
 } = require('@ygracs/bsfoc-lib-js');
 
+const {
+  TItemsListEx,
+} = require('@ygracs/lists-lib-js');
+
 const {
   isHTMLElement, isSelectedHTMLElement, isHiddenHTMLElement,
   showHTMLElement, hideHTMLElement,
@@ -85,15 +89,23 @@ const ILC_SMODE_CTRL = 2;
  * (* class definitions *)
  */
 
+/**
+ * @typedef {Object} OPT_hlconsett
+ * @property {boolean} [autoHideNewItems=false]
+ * @property {boolean} [markCurrentItem=false]
+ * @property {(string|string[])} [itemBaseClassID]
+ * @description An options set for `THtmlItemsListContainer`-class
+ */
+
 /**
  * @classdesc This class implements an interfaco for a list container
  */
 class THtmlItemsListContainer {
-  /** @property {?HTMLElement} */
+  /** @type {?HTMLElement} */
   #_host;
-  /** @property {TItemsListEx} */
+  /** @type {TItemsListEx} */
   #_items;
-  /** @property {object} */
+  /** @type {OPT_hlconsett} */
   #_options;// = null;
   /**
    * @typedef {Object} statILCont
@@ -102,15 +114,12 @@ class THtmlItemsListContainer {
    * @inner
    * @description A container status
    */
-  /** @property {statILCont} */
+  /** @type {statILCont} */
   #_status;
 
   /**
    * @param {HTMLElement} host
-   * @param {object} [opt]
-   * @param {boolean} [opt.autoHideNewItems=false]
-   * @param {boolean} [opt.markCurrentItem=false]
-   * @param {(string|string[])} [opt.itemBaseClassID]
+   * @param {OPT_hlconsett} [opt] - options
    * @description Creates an instance of a list container
    */
   constructor(host, opt) {
@@ -120,6 +129,7 @@ class THtmlItemsListContainer {
     const _items = new TItemsListEx();
     this.#_items = _items;
     // load options
+    /** @type {OPT_hlconsett} */
     const _options = isPlainObject(opt) ? opt : {};
     let {
       autoHideNewItems,
@@ -146,63 +156,63 @@ class THtmlItemsListContainer {
   }
 
   /**
-   * @property {number}
+   * Contains a Qty of an elements
+   * @type {number}
    * @readonly
-   * @description Contains a Qty of an elements
    */
   get count() {
     return this.#_items.count;
   }
 
   /**
-   * @property {number}
+   * Contains an of the current element
+   * @type {number}
    * @readonly
-   * @description Contains an of the current element
    */
   get curIndex() {
     return this.#_items.curIndex;
   }
 
   /**
-   * @property {number}
+   * Returns a minimum value of an index
+   * @type {number}
    * @readonly
-   * @description Returns a minimum value of an index
    */
   get minIndex() {
     return this.#_items.minIndex;
   }
 
   /**
-   * @property {number}
+   * Returns a maximum value of an index
+   * @type {number}
    * @readonly
-   * @description Returns a maximum value of an index
    */
   get maxIndex() {
     return this.#_items.maxIndex;
   }
 
   /**
-   * @property {number}
+   * Returns a value of a previous index
+   * @type {number}
    * @readonly
-   * @description Returns a value of a previous index
    */
   get prevIndex() {
     return this.#_items.prevIndex;
   }
 
   /**
-   * @property {number}
+   * Returns a value of a next index
+   * @type {number}
    * @readonly
-   * @description Returns a value of a next index
    */
   get nextIndex() {
     return this.#_items.nextIndex;
   }
 
   /**
-   * @property {?HTMLElement}
+   * Returns an element in the current index
+   * @type {?HTMLElement}
    * @readonly
-   * @description Returns an element in the current index
    */
   get curItem() {
     const item = this.#_items.curItem;
@@ -471,19 +481,31 @@ class THtmlItemsListContainer {
 
 };
 
+/**
+ * @typedef {Object} OPT_hlctlsett
+ * @property {boolean} [autoHideNewItems=false]
+ * @property {boolean} [markCurrentItem=false]
+ * @property {(string|string[])} [itemBaseClassID]
+ * @property {boolean} [showStubsIfEmpty=false]
+ * @property {boolean} [allowGroupSelection=false]
+ * @property {boolean} [allowSelectionLocks=false]
+ * @property {object} [stubs]
+ * @description An options set for `THtmlItemsListController`-class
+ */
+
 /**
  * @augments THtmlItemsListContainer
  * @classdesc This class enhanced a capabilities implemented
  *            in the `THtmlItemsListContainer` class
  */
 class THtmlItemsListController extends THtmlItemsListContainer {
-  /** @property {?HTMLElement} */
+  /** @type {?HTMLElement} */
   #_host;
-  /** @property {THtmlStubItemsSet} */
+  /** @type {THtmlStubItemsSet} */
   #_stubs;
-  /** @property {Set} */
+  /** @type {Set<HTMLElement>} */
   #_selects;
-  /** @property {object} */
+  /** @property {OPT_hlctlsett} */
   #_options;// = null;
   /**
    * @typedef {Object} statILCtrl
@@ -499,19 +521,12 @@ class THtmlItemsListController extends THtmlItemsListContainer {
    */
   /** @property {statILCtrl} */
   #_status;
-  /** @property {Map} */
+  /** @property {Map<string, Function>} */
   #_events;
 
   /**
    * @param {?HTMLElement} host
-   * @param {object} [opt]
-   * @param {boolean} [opt.autoHideNewItems=false]
-   * @param {boolean} [opt.markCurrentItem=false]
-   * @param {(string|string[])} [opt.itemBaseClassID]
-   * @param {boolean} [opt.showStubsIfEmpty=false]
-   * @param {boolean} [opt.allowGroupSelection=false]
-   * @param {boolean} [opt.allowSelectionLocks=false]
-   * @param {object} [opt.stubs]
+   * @param {OPT_hlctlsett} [opt]
    * @description Creates a new instance of the class.
    */
   constructor(host, opt) {
@@ -638,9 +653,9 @@ class THtmlItemsListController extends THtmlItemsListContainer {
   };
 
   /**
-   * @property {HTMLElement[]}
+   * Returns a list of the selected elements
+   * @type {HTMLElement[]}
    * @readonly
-   * @description Returns a list of the selected elements
    */
   get SelectedItems() {
     const _selects = this.#_selects;
@@ -653,18 +668,18 @@ class THtmlItemsListController extends THtmlItemsListContainer {
   }
 
   /**
-   * @property {THtmlStubItemsSet}
+   * Returns a `THtmlStubItemsSet` instance
+   * @type {THtmlStubItemsSet}
    * @readonly
-   * @description Returns a `THtmlStubItemsSet` instance
    */
   get StubItems() {
     return this.#_stubs;
   }
 
   /**
-   * @property {boolean}
+   * Indicates whether a selection is locked
+   * @type {boolean}
    * @readonly
-   * @description Indicates whether a selection is locked
    */
   get isSelectionLocked() {
     return this.#_status.isSelectionLocked;

package/lib/html-ctrls/lists-btn.js

@@ -1,4 +1,4 @@
-// [v0.1.052-20241119]
+// [v0.1.053-20250416]
 
 // === module init block ===
 
@@ -48,9 +48,9 @@ const BTS_DEF_GROUP_NAME = 'all';
  *            A set provide a buttons: <next>, <previous>, <first> and <last>.
  */
 class THtmlListButtonsController {
-  /** @property {THtmlButtonsSet} */
+  /** @type {THtmlButtonsSet} */
   #_btnSet;
-  /** @property {Map} */
+  /** @type {Map<string, Function>} */
   #_events;
 
   /**

package/lib/html-ctrls/lists-stubs.js

@@ -1,4 +1,4 @@
-// [v0.1.045-20241119]
+// [v0.1.046-20250416]
 
 // === module init block ===
 
@@ -26,15 +26,23 @@ const {
  * (* class definitions *)
  */
 
+/**
+ * @typedef {Object} OPT_ldstubs
+ * @property {string} [defaultItem] - a default element name
+ * @property {boolean} [useClear=true] - to clear before load an elements
+ * @property {boolean} [force=false] - run in a force mode
+ * @description A settings to load stub-elements.
+ */
+
 /**
  * @classdesc This class implements an interface of a stub-items set
  */
 class THtmlStubItemsSet {
-  /** @property {?HTMLElement} */
+  /** @type {?HTMLElement} */
   #_host;
-  /** @property {Map} */
+  /** @type {Map<string, HTMLElement>} */
   #_items;
-  /** @property {string} */
+  /** @type {string} */
   #_defItem;
   #_shownItem = null;
 
@@ -47,7 +55,7 @@ class THtmlStubItemsSet {
 
   /**
    * @param {HTMLElement} host
-   * @param {(array|object|OBJ_stubEList)} opt
+   * @param {(array|object|OBJ_stubEList)} opt - options
    * @param {(array|object)} opt.items
    * @param {string} opt.defaultItem
    * @param {boolean} opt.force - <*deprecated (since: v0.0.23)*>
@@ -66,8 +74,8 @@ class THtmlStubItemsSet {
   }
 
   /**
-   * @property {string}
-   * @description Defines a default element name
+   * Defines a default element name
+   * @type {string}
    */
   get defItem() {
     return this.#_defItem;
@@ -78,9 +86,9 @@ class THtmlStubItemsSet {
   }
 
   /**
-   * @property {number}
+   * Contains a Qty of an elements
+   * @type {number}
    * @readonly
-   * @description Contains a Qty of an elements
    */
   get count() {
     return this.#_items.size;
@@ -228,19 +236,12 @@ class THtmlStubItemsSet {
     return this.hideItem(this.#_defItem);
   }
 
-  /**
-   * @typedef {Object} OPT_ldstubs
-   * @property {string} [defaultItem] - a default element name
-   * @property {boolean} [useClear=true] - to clear before load an elements
-   * @property {boolean} [force=false] - run in a force mode
-   * @description A settings to load stub-elements.
-   */
-
   /**
    * @param {(Array|OBJ_stubEList)} list - an array of entries or special object
    * @param {(boolean|OPT_ldstubs)} [opt] - an options
    * @returns {number}
    * @description Adds an items to an instance members.
+   * @todo [since 0.0.25] deprecate use of `opt` as `boolean`
    */
   loadItems(list, opt) {
     let _options = opt;

package/lib/html-ctrls/mod-hfunc.js

@@ -1,4 +1,4 @@
-// [v0.1.062-20241115]
+// [v0.1.063-20250220]
 
 // === module init block ===
 
@@ -42,9 +42,7 @@ function readOnClickEventInfo(e) {
       item = e.currentTarget;
       break;
     }
-    default: {
-      break;
-    }
+    default: {}
   };
   return { item, onClickNum };
 };

package/lib/html-helper-lib.js

@@ -1,4 +1,4 @@
-// [v0.1.036-20241110]
+// [v0.1.039-20250329]
 
 // === module init block ===
 
@@ -93,11 +93,6 @@ function hideHTMLElement(obj) {
   return isSUCCEED;
 };
 
-/** @deprecated */
-function hideHtmlElement(obj) {
-  return hideHTMLElement(obj);
-};
-
 /**
  * @since v0.0.23
  * @function showHTMLElement
@@ -111,11 +106,6 @@ function showHTMLElement(obj) {
   return isSUCCEED;
 };
 
-/** @deprecated */
-function showHtmlElement(obj) {
-  return showHTMLElement(obj);
-};
-
 /**
  * @since v0.0.23
  * @function selectHTMLElement
@@ -129,11 +119,6 @@ function selectHTMLElement(obj) {
   return isSUCCEED;
 };
 
-/** @deprecated */
-function selectHtmlElement(obj) {
-  return selectHTMLElement(obj);
-};
-
 /**
  * @since v0.0.23
  * @function unselectHTMLElement
@@ -147,11 +132,6 @@ function unselectHTMLElement(obj) {
   return isSUCCEED;
 };
 
-/** @deprecated */
-function unselectHtmlElement(obj) {
-  return unselectHTMLElement(obj);
-};
-
 /**
  * @since v0.0.23
  * @function markHTMLElementAsCurrent
@@ -165,11 +145,6 @@ function markHTMLElementAsCurrent(obj) {
   return isSUCCEED;
 };
 
-/** @deprecated */
-function markHtmlElementAsCurrent(obj) {
-  return markHTMLElementAsCurrent(obj);
-};
-
 /**
  * @since v0.0.23
  * @function unmarkCurrentHTMLElement
@@ -183,11 +158,6 @@ function unmarkCurrentHTMLElement(obj) {
   return isSUCCEED;
 };
 
-/** @deprecated */
-function unmarkCurrentHtmlElement(obj) {
-  return unmarkCurrentHTMLElement(obj);
-};
-
 /**
  * @since v0.0.23
  * @function markHTMLElementAsActive
@@ -201,11 +171,6 @@ function markHTMLElementAsActive(obj) {
   return isSUCCEED;
 };
 
-/** @deprecated */
-function markHtmlElementAsActive(obj) {
-  return markHTMLElementAsActive(obj);
-};
-
 /**
  * @since v0.0.23
  * @function unmarkActiveHTMLElement
@@ -219,11 +184,6 @@ function unmarkActiveHTMLElement(obj) {
   return isSUCCEED;
 };
 
-/** @deprecated */
-function unmarkActiveHtmlElement(obj) {
-  return unmarkActiveHTMLElement(obj);
-};
-
 /**
  * @since v0.0.23
  * @function lockHTMLElement
@@ -250,11 +210,6 @@ function lockHTMLElement(obj) {
   return isSUCCEED;
 };
 
-/** @deprecated */
-function lockHtmlElement(obj) {
-  return lockHTMLElement(obj);
-};
-
 /**
  * @since v0.0.23
  * @function unlockHTMLElement
@@ -273,19 +228,12 @@ function unlockHTMLElement(obj) {
         obj.disabled = false;
         break;
       }
-      default: {
-        break;
-      }
+      default: {}
     };
   };
   return isSUCCEED;
 };
 
-/** @deprecated */
-function unlockHtmlElement(obj) {
-  return unlockHTMLElement(obj);
-};
-
 /**
  * @since v0.0.23
  * @function activateHTMLElements
@@ -299,11 +247,6 @@ function activateHTMLElements(...args) {
   };
 };
 
-/** @deprecated */
-function activateHtmlElements(...args) {
-  activateHTMLElements(...args);
-};
-
 /**
  * @since v0.0.23
  * @function inactivateHTMLElements
@@ -317,11 +260,6 @@ function inactivateHTMLElements(...args) {
   };
 };
 
-/** @deprecated */
-function inactivateHtmlElements(...args) {
-  inactivateHTMLElements(...args);
-};
-
 /**
  * @since v0.0.21
  * @function readAsTagName
@@ -391,9 +329,7 @@ function readAsAttrValue(value) {
       result = value.trim();
       break;
     }
-    default: {
-      break;
-    }
+    default: {}
   };
   return result;
 };
@@ -460,13 +396,14 @@ function valueToElementID(value) {
  */
 
 /**
- * @function createNewHtmlElement
+ * @since 0.0.25
+ * @function createNewHTMLElement
  * @param {string} tagName - an element tag name
  * @param {elemDesc} [opt] - an element description object
  * @return {?HTMLElement}
  * @description Creates a new HTML-element.
  */
-function createNewHtmlElement(tagName, opt) {
+function createNewHTMLElement(tagName, opt) {
   let item = null;
   let _tag = readAsTagName(tagName);
   if (_tag === '') return null;
@@ -538,6 +475,11 @@ function createNewHtmlElement(tagName, opt) {
   return item;
 };
 
+/** @deprecated */
+function createNewHtmlElement(...args) {
+  return createNewHTMLElement(...args);
+};
+
 /***
  * (* class definitions *)
  */
@@ -574,7 +516,7 @@ module.exports.inactivateHTMLElements = inactivateHTMLElements;
 module.exports.valueToClassList = valueToClassList;
 
 // experimental
-module.exports.createNewHtmlElement = createNewHtmlElement;
+module.exports.createNewHTMLElement = createNewHTMLElement;
 module.exports.readAsAttrValue = readAsAttrValue;
 module.exports.readAsTagName = readAsTagName;
 module.exports.readAsAttrName = readAsAttrName;
@@ -584,15 +526,4 @@ module.exports.valueToElementID = valueToElementID;
 module.exports.valueToIDString = valueToIDString;
 
 // @deprecated
-module.exports.showHtmlElement = showHtmlElement;
-module.exports.hideHtmlElement = hideHtmlElement;
-module.exports.selectHtmlElement = selectHtmlElement;
-module.exports.unselectHtmlElement = unselectHtmlElement;
-module.exports.markHtmlElementAsCurrent = markHtmlElementAsCurrent;
-module.exports.unmarkCurrentHtmlElement = unmarkCurrentHtmlElement;
-module.exports.markHtmlElementAsActive = markHtmlElementAsActive;
-module.exports.unmarkActiveHtmlElement = unmarkActiveHtmlElement;
-module.exports.lockHtmlElement = lockHtmlElement;
-module.exports.unlockHtmlElement = unlockHtmlElement;
-module.exports.activateHtmlElements = activateHtmlElements;
-module.exports.inactivateHtmlElements = inactivateHtmlElements;
+module.exports.createNewHtmlElement = createNewHtmlElement;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cntwg/html-helper",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "A base HTML-helper library for js",
   "author": "ygracs <cs70th-om@rambler.ru>",
   "license": "MIT",
@@ -52,12 +52,13 @@
     "#test-dir/*": "./__test__/*"
   },
   "dependencies": {
-    "@ygracs/bsfoc-lib-js": "^0.2.1"
+    "@ygracs/bsfoc-lib-js": "^0.2.3",
+    "@ygracs/lists-lib-js": "^0.0.4"
   },
   "devDependencies": {
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
-    "jsdoc-to-markdown": "^9.0.5",
+    "jsdoc-to-markdown": "^9.1.1",
     "minimist": "^1.2.8"
   }
 }