@cntwg/html-helper 0.0.24 → 0.0.25

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+#### *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.

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-helper-lib.js

@@ -1,4 +1,4 @@
-// [v0.1.037-20250220]
+// [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
@@ -279,11 +234,6 @@ function unlockHTMLElement(obj) {
   return isSUCCEED;
 };
 
-/** @deprecated */
-function unlockHtmlElement(obj) {
-  return unlockHTMLElement(obj);
-};
-
 /**
  * @since v0.0.23
  * @function activateHTMLElements
@@ -297,11 +247,6 @@ function activateHTMLElements(...args) {
   };
 };
 
-/** @deprecated */
-function activateHtmlElements(...args) {
-  activateHTMLElements(...args);
-};
-
 /**
  * @since v0.0.23
  * @function inactivateHTMLElements
@@ -315,11 +260,6 @@ function inactivateHTMLElements(...args) {
   };
 };
 
-/** @deprecated */
-function inactivateHtmlElements(...args) {
-  inactivateHTMLElements(...args);
-};
-
 /**
  * @since v0.0.21
  * @function readAsTagName
@@ -456,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;
@@ -534,6 +475,11 @@ function createNewHtmlElement(tagName, opt) {
   return item;
 };
 
+/** @deprecated */
+function createNewHtmlElement(...args) {
+  return createNewHTMLElement(...args);
+};
+
 /***
  * (* class definitions *)
  */
@@ -570,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;
@@ -580,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.24",
+  "version": "0.0.25",
   "description": "A base HTML-helper library for js",
   "author": "ygracs <cs70th-om@rambler.ru>",
   "license": "MIT",
@@ -52,7 +52,8 @@
     "#test-dir/*": "./__test__/*"
   },
   "dependencies": {
-    "@ygracs/bsfoc-lib-js": "^0.2.2"
+    "@ygracs/bsfoc-lib-js": "^0.2.3",
+    "@ygracs/lists-lib-js": "^0.0.4"
   },
   "devDependencies": {
     "jest": "^29.7.0",