@ygracs/xepg-lib-js 0.0.22 → 0.0.24

package/lib/xepgdoc-lib.js

@@ -1,12 +1,12 @@
-// [v0.2.098-20250306]
+// [v0.2.124-20250730]
 
 // === module init block ===
 
 const xmlParser = require('@ygracs/xml-js6');
 
 const {
-  valueToIndex,
-  readAsString, readAsNumberEx,
+  valueToIndex, valueToIDString,
+  readAsString, readAsNumber,
   isNotEmptyString,
   isArray, isObject, isPlainObject,
 } = require('@ygracs/bsfoc-lib-js');
@@ -22,19 +22,21 @@ const {
 } = require('./dts-helper.js');
 
 const {
-  loadFileSync, loadFile,
+  loadFromFileSync, loadFromFile,
   saveToFileSync, saveToFile,
-} = require('./file-helper.js');
+} = require('@cntwg/file-helper');
 
 const xObj = require('@ygracs/xobj-lib-js');
 
-const TXmlContentParseOptions = xObj.TXmlContentParseOptions;
 const {
+  TXmlContentParseOptions,
   getXObjElement,
   insertXObjElement,
+  writeXObjParam,
+  writeXObjAttr,
 } = xObj;
 
-// === module extra block (helper functions) ===
+// === module inner block ===
 
 /*
  * === xObj-function wrappers (start) ===
@@ -44,33 +46,27 @@ function readXObjParam(obj){
   return xObj.readXObjParam(obj, defParseOptions.settings.textKey);
 };
 
-function writeXObjParam(obj, value){
-  return xObj.writeXObjParam(obj, value, defParseOptions.settings.textKey);
-};
-
-function writeXObjAttr(obj, name, value) {
-  return xObj.writeXObjAttr(
-    obj, name, value, defParseOptions.settings.attributesKey
-  );
-};
-
 /*
  * === xObj-function wrappers (end) ===
  */
 
+/***
+ * (* helper function definitions *)
+ */
+
 /**
- * @param {object} obj
- * @param {string} elem
+ * @param {object} obj - element
+ * @param {string} name - child element name
  * @returns {string}
  * @inner
  */
-function _getXmlChildElementParam(obj, elem) {
-  const child = obj ? getXObjElement(obj, elem) : null;
+function _getXmlChildElementParam(obj, name) {
+  const child = obj ? getXObjElement(obj, name) : null;
   return child ? readXObjParam(child) : '';
 };
 
 /**
- * @param {object} obj
+ * @param {object} obj - element
  * @returns {number}
  * @inner
  */
@@ -81,19 +77,114 @@ function _getDTSTypeValueForXObj(obj) {
   return chkDTSysID(result) ? result : 0; //-1; // // TODO: [?]
 };
 
-function writeXEpgDocDeclSection(obj, opt) {
+/**
+ * @param {object} obj - element
+ * @param {*} data - data
+ * @returns {void}
+ * @inner
+ */
+function writeXEpgDocDeclSection(obj, data) {
+  const key_name = defParseOptions.settings.declarationKey;
   let xml_ver = XEPG_XML_DOC_VERSION;
   let doc_def_enc = XEPG_DEF_ENCODING_VALUE;
-  let key_name = defParseOptions.settings.declarationKey;
-  if (isPlainObject(opt)) {
-    xml_ver = readAsString(opt.version, { defValue: xml_ver });
-    doc_def_enc = readAsString(opt.encoding, { defValue: doc_def_enc });
+  if (isPlainObject(data)) {
+    xml_ver = readAsString(data.version, { defValue: xml_ver });
+    doc_def_enc = readAsString(data.encoding, { defValue: doc_def_enc });
   };
   if (isPlainObject(obj) && isNotEmptyString(key_name)) {
     obj[key_name] = {};
-    writeXObjAttr(obj[key_name], 'version', xml_ver);
-    writeXObjAttr(obj[key_name], 'encoding', doc_def_enc);
+    const attr_key = defParseOptions.settings.attributesKey;
+    writeXObjAttr(obj[key_name], 'version', xml_ver, attr_key);
+    writeXObjAttr(obj[key_name], 'encoding', doc_def_enc, attr_key);
+  };
+};
+
+/**
+ * Returns an object as a string in an XML-format.
+ * @since v0.0.24
+ * @function serializeXObjToXMLString
+ * @param {object} node - some element
+ * @param {object} opt - parser options
+ * @param {string} tagName - element tag name
+ * @returns {string}
+ * @inner
+ */
+function serializeXObjToXMLString(node, opt, tagName) {
+  let result = '';
+  try {
+    result = xmlParser.js2xml({ [tagName]: node }, opt);
+  } catch (err) {
+    //console.log('CHECK: serializeXObjToXMLString() => Error => '+err);
+    result = '';
+    //throw err;
+  };
+  return result;
+};
+
+/**
+ * Loads an object content from an XML-string.
+ * @since v0.0.24
+ * @function deserializeXObjFromXMLString
+ * @param {object} node - some element
+ * @param {object} opt - parser options
+ * @param {string} text - some content
+ * @param {string} tagName - element tag name
+ * @returns {boolean}
+ * @throws {Error}
+ * @inner
+ * @experimental
+ */
+function deserializeXObjFromXMLString(node, opt, text, tagName) {
+  let result = false;
+  if (typeof text === 'string' && text !== '') {
+    try {
+      let obj = xmlParser.xml2js(text, opt);
+      if (isPlainObject(obj)) {
+        obj = obj[tagName];
+        if (isPlainObject(obj)) {
+          for (let prop in node) {
+            // // TODO: catch errors in strict mode
+            delete node[prop];
+          };
+          (Object.entries(obj)).forEach(([key, value]) => {
+            node[key] = value;
+          });
+          result = true;
+        };
+      };
+    } catch (err) {
+      //console.log('CHECK: deserializeXObjFromXMLString() => Error => '+err);
+      //console.log('CHECK: deserializeXObjFromXMLString() => Error => '+err.code);
+      throw err;
+    };
   };
+  return result;
+};
+
+/**
+ * An XEPG-element options set (base)
+ * @typedef {Object} OPT_epgelsett_bs
+ * @property {TXmlContentParseOptions} [parseOptions] - parser options
+ */
+
+/**
+ * Evaluates an XML-node base settings
+ * @function __evalXMLBaseNodeSettings
+ * @param {any} value - element settings to evaluate
+ * @returns {OPT_epgelsett_bs}
+ * @inner
+ */
+function __evalXMLBaseNodeSettings(value) {
+  /** @type {OPT_epgelsett_bs} */
+  let settings = isPlainObject(value) ? value : {};
+  if (settings instanceof Map) settings = Object.fromEntries(settings);
+  let {
+    parseOptions,
+  } = settings;
+  if (!(parseOptions instanceof TXmlContentParseOptions)) {
+    settings.parseOptions = new TXmlContentParseOptions(parseOptions);
+  };
+  return settings;
 };
 
 // === module main block ===
@@ -161,56 +252,141 @@ const defParseOptions = new TXmlContentParseOptions();
  * (* function definitions *)
  */
 
+/**
+ * Tries to convert a given value to a valid tag name of an XML-element.
+ * @since v0.0.23
+ * @function readAsTagName
+ * @param {any} value - some value
+ * @returns {string}
+ */
+function readAsTagName(value) {
+  let tagName = valueToIDString(value, { ignoreNumbers: true });
+  if (tagName === null) return '';
+  if (tagName !== '') {
+    // // TODO: do extra checks
+    const template = /[\s\/\\\"\'<>=]/;
+    const trigger = tagName.match(template);
+    if (trigger) {
+      //console.log(trigger);
+      tagName = '';
+    };
+  };
+  return tagName;
+};
+
+/**
+ * Tries to convert a given value to a valid name of an XML-attribute.
+ * @since v0.0.23
+ * @function readAsAttrName
+ * @param {any} value - some value
+ * @returns {string}
+ */
+function readAsAttrName(value) {
+  let attrName = valueToIDString(value, { ignoreNumbers: true });
+  if (attrName === null) return '';
+  if (attrName !== '') {
+    // // TODO: do extra checks
+    const template = /[\s\/\\\"\'<>=]/;
+    const trigger = attrName.match(template);
+    if (trigger) {
+      //console.log(trigger);
+      attrName = '';
+    };
+  };
+  return attrName;
+};
+
+/**
+ * Tries to convert a given value to a valid identifier suitable as a value
+ * for an "ID-attribute" of an XML-element.
+ * @since v0.0.23
+ * @function valueToElementID
+ * @param {any} value - some value
+ * @returns {string}
+ */
+function valueToElementID(value) {
+  let id = valueToIDString(value);
+  if (id === null) return '';
+  if (id !== '') {
+    // // TODO: do extra checks
+    const template = /[\s\/\\\"\'<>=]/;
+    const trigger = id.match(template);
+    if (trigger) {
+      //console.log(trigger);
+      id = '';
+    };
+  };
+  return id;
+};
+
 /***
  * (* class definitions *)
  */
 
 /**
+ * A schedule info descriptor
  * @typedef {Object} xepgShedInfoDesc
  * @property {number} time - a schedule start time
  * @property {string} title - schedule title
  * @property {string} [cat] - schedule category
  * @property {number} [pcmark] - schedule rating
  * @property {string} [descr] - schedule description
- * @description A schedule info descriptor
  */
 
 /**
+ * An extra options set
+ * @typedef {Object} OPT_extra
+ * @property {object} [dts_src] - 'DTS'-settings
+ * @property {object} [tz_src] - 'TZ'-settings
+ */
+
+/**
+ * An XEPG-element options set (extend)
+ * @typedef {Object} OPT_epgelsett_ex
+ * @property {TXmlContentParseOptions} [parseOptions] - parser options
+ * @property {object} [dts_src]
+ * @property {object} [tz_src]
+ */
+
+/**
+ * @since 0.0.22
  * @classdesc This class implements an interface of a EPG-schedule element
  */
 class TXEpgScheduleItem {
-  /** @property {object} */
-  #_host;// = null;
-  /** @property {object} */
-  #_options;// = null;
-  /** @property {TXmlContentParseOptions} */
-  #_parseOptions;// = null;
-  /** @property {?object} */
+  /** @type {object} */
+  #_host;
+  /** @type {OPT_epgelsett_ex} */
+  #_options;
+  /** @type {TXmlContentParseOptions} */
+  #_parseOptions;
+  /** @type {?object} */
   #_dts_src = null;
-  /** @property {?object} */
+  /** @type {?object} */
   #_tz_src = null;
 
   /**
+   * Creates an instance of the EPG-schedule element
    * @param {object} obj - host object
-   * @param {object} [opt] - options
-   * @param {object} [opt.parseOptions]
-   * @param {?object} [opt.dts_src]
-   * @param {?object} [opt.tz_src]
-   * @description Creates an instance of the EPG-schedule element
+   * @param {OPT_epgelsett_ex} [opt] - options
+   * @param {OPT_extra} [extra] - \[since `v0.0.24`] extra options
    */
-  constructor(obj, opt) {
+  constructor(obj, opt, extra) {
     // load content
     const _host = isPlainObject(obj) ? obj : {};
     // load options
+    /** @type {OPT_epgelsett_ex} */
     const _options = isPlainObject(opt) ? opt : {};
     let {
       parseOptions,
-      dts_src, tz_src,
     } = _options;
     if (!(parseOptions instanceof TXmlContentParseOptions)) {
       parseOptions = new TXmlContentParseOptions(parseOptions);
       _options.parseOptions = parseOptions;
     };
+    let {
+      dts_src = _options.dts_src,
+      tz_src = _options.tz_src,
+    } = isPlainObject(extra) ? extra : {};
     if (!isPlainObject(dts_src)) dts_src = null;
     if (!isPlainObject(tz_src)) tz_src = null;
     // save content source
@@ -226,7 +402,7 @@ class TXEpgScheduleItem {
 
   /**
    * Contains a dtstype ID
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get dtstype() {
@@ -235,7 +411,7 @@ class TXEpgScheduleItem {
 
   /**
    * Contains a TZ-offset
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get curDocTZ() {
@@ -248,7 +424,7 @@ class TXEpgScheduleItem {
 
   /**
    * Contains a schedule start time as a timestamp
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get time() {
@@ -260,7 +436,7 @@ class TXEpgScheduleItem {
 
   /**
    * Contains a schedule title
-   * @property {string}
+   * @type {string}
    * @readonly
    */
   get title() {
@@ -269,7 +445,7 @@ class TXEpgScheduleItem {
 
   /**
    * Contains a schedule category
-   * @property {string}
+   * @type {string}
    * @readonly
    */
   get category() {
@@ -278,18 +454,18 @@ class TXEpgScheduleItem {
 
   /**
    * Contains a schedule rating value (aka pcmark)
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get rating() {
-    return readAsNumberEx(
+    return readAsNumber(
       _getXmlChildElementParam(this.#_host, XEPG_SCHEDPMARK_ETAG_NAME), 0
     );
   }
 
   /**
    * Contains a schedule description
-   * @property {string}
+   * @type {string}
    * @readonly
    */
   get descr() {
@@ -297,8 +473,8 @@ class TXEpgScheduleItem {
   }
 
   /**
+   * Returns a schedule info item descriptor
    * @returns {xepgShedInfoDesc}
-   * @description Returns a schedule info item descriptor
    */
   getInfo() {
     const {
@@ -318,9 +494,9 @@ class TXEpgScheduleItem {
   }
 
   /**
+   * Sets a schedule start time.
    * @param {(number|string|Date)} value - some time value
    * @returns {boolean}
-   * @description Sets a schedule start time.
    */
   setTime(value) {
     let { isSucceed, value: dtValue } = tryDTValue(value);
@@ -330,46 +506,52 @@ class TXEpgScheduleItem {
       if (dtValue !== '') {
         const opt = { force: true };
         const item = insertXObjElement(this.#_host, XEPG_SCHEDTIME_ETAG_NAME, opt);
-        if (item) result = writeXObjParam(item, dtValue);
+        if (item) {
+          result = writeXObjParam(item, dtValue, defParseOptions.settings.textKey);
+        };
       };
     };
     return result;
   }
 
   /**
+   * Sets a schedule title.
    * @param {string} value - some title
    * @returns {boolean}
-   * @description Sets a schedule title.
    */
   setTitle(value) {
     let result = false;
     if (typeof value === 'string') {
       const opt = { force: true };
       const item = insertXObjElement(this.#_host, XEPG_SCHEDTITL_ETAG_NAME, opt);
-      if (item) result = writeXObjParam(item, value.trim());
+      if (item) {
+        result = writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
     };
     return result;
   }
 
   /**
+   * Sets a schedule title.
    * @param {string} value - some title
    * @returns {boolean}
-   * @description Sets a schedule title.
    */
   setCategory(value) {
     let result = false;
     if (typeof value === 'string') {
       const opt = { force: true };
       const item = insertXObjElement(this.#_host, XEPG_SCHEDCAT_ETAG_NAME, opt);
-      if (item) result = writeXObjParam(item, value.trim());
+      if (item) {
+        result = writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
     };
     return result;
   }
 
   /**
+   * Sets a schedule rating value.
    * @param {(number|string)} value - some value
    * @returns {boolean}
-   * @description Sets a schedule rating value.
    */
   setRating(value) {
     const _value = valueToIndex(value);
@@ -377,44 +559,63 @@ class TXEpgScheduleItem {
     if (_value !== -1) {
       const opt = { force: true };
       const item = insertXObjElement(this.#_host, XEPG_SCHEDPMARK_ETAG_NAME, opt);
-      if (item) result = writeXObjParam(item, _value);
+      if (item) {
+        result = writeXObjParam(item, _value, defParseOptions.settings.textKey);
+      };
     };
     return result;
   }
 
   /**
+   * Sets a schedule description.
    * @param {string} value - some text
    * @returns {boolean}
-   * @description Sets a schedule description.
    */
   setDescr(value) {
     let result = false;
     if (typeof value === 'string') {
       const opt = { force: true };
       const item = insertXObjElement(this.#_host, XEPG_SCHEDDESC_ETAG_NAME, opt);
-      if (item) result = writeXObjParam(item, value.trim());
+      if (item) {
+        result = writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
     };
     return result;
   }
 
   /**
+   * Returns an instance content as a string in an XML-format.
    * @returns {string}
-   * @description Returns an instance content as a string in an XML-format.
    */
   saveToXMLString() {
     const options = this.#_parseOptions.js2xml;
     options.ignoreDocType = true;
     options.ignoreDeclaration = true;
-    const content = { [`${XEPG_SCHED_ETAG_NAME}`]: this.#_host };
-    let result = '';
-    try {
-      result = xmlParser.js2xml(content, options);
-    } catch (err) {
-      //console.log('CHECK: TXEpgHeaderContainer.saveToXMLString() => Error => '+err);
-      result = '';
-      //throw err;
-    };
-    return result;
+    return serializeXObjToXMLString(
+      this.#_host,
+      options,
+      XEPG_SCHED_ETAG_NAME,
+    );
+  }
+
+  /**
+   * Loads an element content from a string.
+   * @since v0.0.24
+   * @param {string} xmlString - some content
+   * @returns {boolean}
+   * @throws {Error}
+   * @experimental
+   */
+  loadFromXMLString(xmlString) {
+    const options = this.#_parseOptions.xml2js;
+    options.ignoreDocType = true;
+    options.ignoreDeclaration = true;
+    return deserializeXObjFromXMLString(
+      this.#_host,
+      options,
+      xmlString,
+      XEPG_SCHED_ETAG_NAME,
+    );
   }
 
 };
@@ -423,26 +624,29 @@ class TXEpgScheduleItem {
  * @classdesc This class implements an interface of a EPG-schedules list
  */
 class TXEpgSchedulesList {
-  /** @property {object[]} */
-  #_content;// = null;
-  /** @property {object} */
-  #_options;// = null;
-  /** @property {?object} */
+  /** @type {object[]} */
+  #_content;
+  /** @type {OPT_epgelsett_ex} */
+  #_options;
+  /** @type {?object} */
   #_dts_src = null;
-  /** @property {?object} */
+  /** @type {?object} */
   #_tz_src = null;
 
   /**
+   * Creates an instance of the schedules list
    * @param {any[]} obj - list of an elements
-   * @param {object} [opt] - options
-   * @param {?object} [opt.dts_src]
-   * @param {?object} [opt.tz_src]
-   * @description Creates an instance of the schedules list
+   * @param {OPT_epgelsett_ex} [opt] - options
+   * @param {OPT_extra} [extra] - \[since `v0.0.24`] extra options
    */
-  constructor(obj, opt) {
+  constructor(obj, opt, extra) {
     const _content = isArray(obj) ? obj : [];
+    /** @type {OPT_epgelsett_ex} */
     const _options = isPlainObject(opt) ? opt : {};
-    let { dts_src, tz_src } = _options;
+    let {
+      dts_src = _options.dts_src,
+      tz_src = _options.tz_src,
+    } = isPlainObject(extra) ? extra : {};
     if (!isPlainObject(dts_src)) dts_src = null;
     if (!isPlainObject(tz_src)) tz_src = null;
     // save content source
@@ -454,11 +658,27 @@ class TXEpgSchedulesList {
     this.#_tz_src = tz_src;
   }
 
+  [Symbol.iterator]() {
+    let index = 0;
+    return {
+      next: () => {
+        if (index < this.count) {
+          return { done: false, value: this.schedule(index++) };
+        } else {
+          return { done: true, value: undefined };
+        };
+      },
+      return() {
+        return { done: true, value: undefined };
+      },
+    };
+  }
+
   /**
+   * Returns a raw schedule element
    * @param {(number|string)} value - element index
    * @returns {any}
    * @private
-   * @description Returns a raw schedule element
    */
   #_getItem = function(value) {
     if (this.chkIndex(value)) {
@@ -468,16 +688,28 @@ class TXEpgSchedulesList {
 
   /**
    * Contains a quantity of a schedules
-   * @property {number}
+   * @type {number}
    * @readonly
+   * @deprecated
+   * @todo \[since `v0.0.24`] deprecated. Use `TXEpgSchedulesList.count`
    */
   get schedQty() {
     return this.#_content.length;
   }
 
+  /**
+   * Contains a quantity of a schedules
+   * @since v0.0.24
+   * @type {number}
+   * @readonly
+   */
+  get count() {
+    return this.#_content.length;
+  }
+
   /**
    * Contains a dtstype ID
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get dtstype() {
@@ -486,7 +718,7 @@ class TXEpgSchedulesList {
 
   /**
    * Contains a TZ-offset
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get curDocTZ() {
@@ -498,51 +730,60 @@ class TXEpgSchedulesList {
   }
 
   /**
+   * Indicates whether an instance has none member
    * @returns {boolean}
-   * @description Indicates whether an instance has none member
+   * @deprecated
+   * @todo \[since `v0.0.24`] deprecated. Use `TXEpgSchedulesList.isEmpty`
    */
   hasNoSchedules() {
-    return this.schedQty === 0;
+    return this.count === 0;
   }
 
   /**
+   * Indicates whether an instance has none member
+   * @since v0.0.24
    * @returns {boolean}
-   * @description Indicates whether an instance has any member
    */
-  hasSchedules() {
-    return this.schedQty > 0;
+  isEmpty() {
+    return this.count === 0;
   }
 
   /**
-   * @param {(number|string)} value
+   * Indicates whether an instance has any member
    * @returns {boolean}
    * @deprecated
-   * @description Checks whether a given value is a valid index
-   *              and it fits the index range of an instance
-   * @done [since v0.0.20] deprecated
-   * @todo [from v0.0.23] will be removed
+   * @todo \[since `v0.0.24`] deprecated. Use `TXEpgSchedulesList.isNotEmpty`
    */
-  chkScheduleIndex(value) {
-    return this.chkIndex(value);
+  hasSchedules() {
+    return this.count > 0;
   }
 
   /**
-   * @param {(number|string)} value - index of some element
+   * Indicates whether an instance has any member
+   * @since v0.0.24
    * @returns {boolean}
+   */
+  isNotEmpty() {
+    return this.count > 0;
+  }
+
+  /**
+   * Checks whether a given value is a valid index and it fits the index range
+   * of an instance
    * @since 0.0.20
-   * @description Checks whether a given value is a valid index
-   *              and it fits the index range of an instance
+   * @param {(number|string)} value - index of some element
+   * @returns {boolean}
    */
   chkIndex(value) {
     const index = valueToIndex(value);
-    return index !== -1 && index < this.schedQty;
+    return index !== -1 && index < this.count;
   }
 
   /**
+   * Returns a schedule element addressed by a given index
+   * @since 0.0.22
    * @param {(number|string)} index - index of some element
    * @returns {?TXEpgScheduleItem}
-   * @since 0.0.22
-   * @description Returns a schedule element addressed by a given index
    */
   schedule(index) {
     const curObj = this.#_getItem(index);
@@ -557,10 +798,10 @@ class TXEpgSchedulesList {
   }
 
   /**
+   * Returns a schedule info item for instance element addressed
+   * by a given index
    * @param {(number|string)} index - index of some element
    * @returns {?xepgShedInfoDesc}
-   * @description Returns a schedule info item for instance element
-   *              addressed by a given index
    */
   getScheduleInfo(index) {
     const obj = this.schedule(index);
@@ -568,12 +809,12 @@ class TXEpgSchedulesList {
   }
 
   /**
+   * Returns a schedule info for instance members
    * @returns {xepgShedInfoDesc[]}
-   * @description Returns a schedule info for instance members
    */
   getAllSchedulesInfo() {
     let result = [];
-    for (let i = 0; i < this.schedQty; i++) {
+    for (let i = 0; i < this.count; i++) {
       let item = this.getScheduleInfo(i);
       if (isPlainObject(item)) result.push(item);
     };
@@ -590,44 +831,38 @@ class TXEpgSchedulesList {
 };
 
 /**
+ * A provider info descriptor
  * @typedef {Object} xepgProvInfoDesc
  * @property {string} [name] - provider name
  * @property {string} [version] - provider version
  * @property {string} schema - document schema
  * @property {string} doctype - document type
- * @description A provider info descriptor
  */
 
 /**
  * @classdesc This class implements an interface of a EPG-provider element
  */
 class TXEpgProviderContainer {
-  /** @property {Object} */
-  #_host;// = null;
-  /** @property {Object} */
-  #_options;// = null;
-  /** @property {TXmlContentParseOptions} */
-  #_parseOptions;// = null;
-  /** @property {?TXEpgDTSProvider} */
+  /** @type {Object} */
+  #_host;
+  /** @type {OPT_epgelsett_bs} */
+  #_options;
+  /** @type {TXmlContentParseOptions} */
+  #_parseOptions;
 
   /**
+   * Creates an instance of the EPG-provider element
    * @param {object} obj - host object
-   * @param {object} [opt] - options
-   * @param {object} [opt.parseOptions]
-   * @description Creates an instance of the EPG-provider element
+   * @param {OPT_epgelsett_bs} [opt] - options
    */
   constructor(obj, opt) {
     // load content
     const _host = isPlainObject(obj) ? obj : {};
     // load options
-    const _options = isPlainObject(opt) ? opt : {};
+    const _options = __evalXMLBaseNodeSettings(opt);
     let {
       parseOptions,
     } = _options;
-    if (!(parseOptions instanceof TXmlContentParseOptions)) {
-      parseOptions = new TXmlContentParseOptions(parseOptions);
-      _options.parseOptions = parseOptions;
-    };
     // save options
     this.#_options = _options;
     // save parser options
@@ -652,7 +887,7 @@ class TXEpgProviderContainer {
 
   /**
    * Contains a provider name
-   * @property {string}
+   * @type {string}
    */
   get name() {
     return _getXmlChildElementParam(this.#_host, 'name').trim();
@@ -664,7 +899,7 @@ class TXEpgProviderContainer {
 
   /**
    * Contains a version of a provider
-   * @property {string}
+   * @type {string}
    */
   get version() {
     return _getXmlChildElementParam(this.#_host, 'version').trim();
@@ -674,13 +909,15 @@ class TXEpgProviderContainer {
     if (typeof value === 'string' && this.name !== '') {
       const opt = { force: true };
       const item = insertXObjElement(this.#_host, 'version', opt);
-      if (item) writeXObjParam(item, value.trim());
+      if (item) {
+        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
     };
   }
 
   /**
    * Contains a version of a document schema
-   * @property {string}
+   * @type {string}
    */
   get schema() {
     return _getXmlChildElementParam(this.#_host, XEPG_DOCSCH_ETAG_NAME).trim();
@@ -690,13 +927,15 @@ class TXEpgProviderContainer {
     if (typeof value === 'string') {
       const opt = { force: true };
       const item = insertXObjElement(this.#_host, XEPG_DOCSCH_ETAG_NAME, opt);
-      if (item) writeXObjParam(item, value.trim());
+      if (item) {
+        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
     };
   }
 
   /**
    * Contains a document type
-   * @property {string}
+   * @type {string}
    */
   get doctype() {
     return _getXmlChildElementParam(this.#_host, XEPG_DOCTYP_ETAG_NAME).trim();
@@ -706,28 +945,32 @@ class TXEpgProviderContainer {
     if (typeof value === 'string') {
       const opt = { force: true };
       const item = insertXObjElement(this.#_host, XEPG_DOCTYP_ETAG_NAME, opt);
-      if (item) writeXObjParam(item, value.trim());
+      if (item) {
+        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
     };
   }
 
   /**
+   * Sets a provider name
    * @param {string} value - provider name
    * @returns {boolean}
-   * @description Sets a provider name
    */
   setName(value) {
     let isSucceed = false;
     if (typeof value === 'string') {
       const name = value.trim();
       const item = insertXObjElement(this.#_host, 'name', { force: true });
-      if (item) isSucceed = writeXObjParam(item, name);
+      if (item) {
+        isSucceed = writeXObjParam(item, name, defParseOptions.settings.textKey);
+      };
     };
     return isSucceed;
   }
 
   /**
+   * Returns a provider info item
    * @returns {xepgProvInfoDesc}
-   * @description Returns a provider info item
    */
   getInfo() {
     return {
@@ -739,9 +982,9 @@ class TXEpgProviderContainer {
   }
 
   /**
+   * Sets a provider info
    * @param {(string[]|xepgProvInfoDesc)} obj - provider info descriptor
    * @returns {void}
-   * @description Sets a provider info
    * @todo [since v0.0.21] deprecate use of `obj`-param as array
    */
   setInfo(obj) {
@@ -776,9 +1019,9 @@ class TXEpgProviderContainer {
   }
 
   /**
+   * Sets an initial instance state
    * @param {(xepgProvInfoDesc|string[])} opt - options
    * @returns {void}
-   * @description Sets an initial instance state
    */
   init(opt) {
     let prov_opt = { ...defXEpgDocOptions.defProviderParam };
@@ -803,68 +1046,79 @@ class TXEpgProviderContainer {
   }
 
   /**
-   * @returns {string}
+   * Returns an instance content as a string in an XML-format.
    * @since v0.0.20
-   * @description Returns an instance content as a string in an XML-format.
+   * @returns {string}
    */
   saveToXMLString() {
     const options = this.#_parseOptions.js2xml;
     options.ignoreDocType = true;
     options.ignoreDeclaration = true;
-    const content = { [`${XEPG_PRVINFO_ETAG_NAME}`]: this.#_host };
-    let result = '';
-    try {
-      result = xmlParser.js2xml(content, options);
-    } catch (err) {
-      //console.log('CHECK: TXEpgHeaderContainer.saveToXMLString() => Error => '+err);
-      result = '';
-      //throw err;
-    };
-    return result;
+    return serializeXObjToXMLString(
+      this.#_host,
+      options,
+      XEPG_PRVINFO_ETAG_NAME,
+    );
+  }
+
+  /**
+   * Loads a element content from a string.
+   * @since v0.0.24
+   * @param {string} xmlString - some content
+   * @returns {boolean}
+   * @throws {Error}
+   * @experimental
+   */
+  loadFromXMLString(xmlString) {
+    const options = this.#_parseOptions.xml2js;
+    options.ignoreDocType = true;
+    options.ignoreDeclaration = true;
+    return deserializeXObjFromXMLString(
+      this.#_host,
+      options,
+      xmlString,
+      XEPG_PRVINFO_ETAG_NAME,
+    );
   }
 
 };
 
 /**
+ * A channel info descriptor
  * @typedef {Object} xepgChnInfoDesc
  * @property {string} chnid - channel ID
  * @property {string} chname - channel name
  * @property {string} [chngid] - channel 'Group ID'
  * @property {string} [srcurl] - EPG-source URL
- * @description A channel info descriptor
  */
 
 /**
+ * @since 0.0.22
  * @classdesc This class implements an interface of a channel element
  */
 class TXEpgChannelContainer {
-  /** @property {object} */
-  #_host;// = null;
-  /** @property {object} */
-  #_options;// = null;
-  /** @property {TXmlContentParseOptions} */
-  #_parseOptions;// = null;
-  /** @property {string} */
-  #_xepgSchema;// = null;
+  /** @type {object} */
+  #_host;
+  /** @type {OPT_epgelsett_bs} */
+  #_options;
+  /** @type {TXmlContentParseOptions} */
+  #_parseOptions;
+  /** @type {string} */
+  #_xepgSchema;
 
   /**
+   * Creates an instance of the channel element
    * @param {object} obj - host object
-   * @param {object} [opt] - options
-   * @param {object} [opt.parseOptions]
-   * @description Creates an instance of the channel element
+   * @param {OPT_epgelsett_bs} [opt] - options
    */
   constructor(obj, opt) {
     // load content
     const _host = isPlainObject(obj) ? obj : {};
     // load options
-    const _options = isPlainObject(opt) ? opt : {};
+    const _options = __evalXMLBaseNodeSettings(opt);
     let {
       parseOptions,
     } = _options;
-    if (!(parseOptions instanceof TXmlContentParseOptions)) {
-      parseOptions = new TXmlContentParseOptions(parseOptions);
-      _options.parseOptions = parseOptions;
-    };
     // set document schema version
     this.#_xepgSchema = XEPG_DEF_DOCUMENT_SCHEMA;
     // save options
@@ -877,7 +1131,7 @@ class TXEpgChannelContainer {
 
   /**
    * Contains a channel ID
-   * @returns {string}
+   * @type {string}
    * @readonly
    */
   get id() {
@@ -886,7 +1140,7 @@ class TXEpgChannelContainer {
 
   /**
    * Contains a channel name
-   * @returns {string}
+   * @type {string}
    */
   get name() {
     return _getXmlChildElementParam(this.#_host, XEPG_CHNNAME_ETAG_NAME).trim();
@@ -899,13 +1153,15 @@ class TXEpgChannelContainer {
         XEPG_CHNNAME_ETAG_NAME,
         { force: true },
       );
-      if (item) writeXObjParam(item, value.trim());
+      if (item) {
+        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
     };
   }
 
   /**
    * Contains a channel Group ID
-   * @returns {string}
+   * @type {string}
    */
   get gid() {
     return _getXmlChildElementParam(this.#_host, XEPG_CHNGID_ETAG_NAME).trim();
@@ -918,13 +1174,15 @@ class TXEpgChannelContainer {
         XEPG_CHNGID_ETAG_NAME,
         { force: true },
       );
-      if (item) writeXObjParam(item, value.trim());
+      if (item) {
+        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
     };
   }
 
   /**
    * Contains a channel source URL
-   * @returns {string}
+   * @type {string}
    */
   get url() {
     return _getXmlChildElementParam(this.#_host, XEPG_CHNURL_ETAG_NAME).trim();
@@ -937,14 +1195,16 @@ class TXEpgChannelContainer {
         XEPG_CHNURL_ETAG_NAME,
         { force: true },
       );
-      if (item) writeXObjParam(item, value.trim());
+      if (item) {
+        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
     };
   }
 
   /**
+   * Tries to set a channel ID
    * @param {string} value - channel ID
    * @returns {boolean}
-   * @description Tries to set a channel ID
    */
   setID(value) {
     let isSucceed = false;
@@ -956,15 +1216,15 @@ class TXEpgChannelContainer {
         { force: true },
       );
       if (item) {
-        isSucceed = writeXObjParam(item, chnid);
+        isSucceed = writeXObjParam(item, chnid, defParseOptions.settings.textKey);
       };
     };
     return isSucceed;
   }
 
   /**
+   * Returns a channel info
    * @returns {xepgChnInfoDesc}
-   * @description Returns a channel info
    */
   getInfo() {
     const {
@@ -983,9 +1243,9 @@ class TXEpgChannelContainer {
   }
 
   /**
+   * Sets a channel info
    * @param {(string|xepgChnInfoDesc)} obj - channel info descriptor
    * @returns {void}
-   * @description Sets a channel info
    */
   setInfo(obj) {
     let chnid = '';
@@ -1020,14 +1280,15 @@ class TXEpgChannelContainer {
     };
     let item = null;
     const _host = this.#_host;
+    const text_key = defParseOptions.settings.textKey;
     item = insertXObjElement(_host, XEPG_CHNID_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, chnid);
+    if (item) writeXObjParam(item, chnid, text_key);
     item = insertXObjElement(_host, XEPG_CHNNAME_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, chname);
+    if (item) writeXObjParam(item, chname, text_key);
     item = insertXObjElement(_host, XEPG_CHNGID_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, chngid);
+    if (item) writeXObjParam(item, chngid, text_key);
     item = insertXObjElement(_host, XEPG_CHNURL_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, srcurl);
+    if (item) writeXObjParam(item, srcurl, text_key);
   }
 
 }
@@ -1036,29 +1297,24 @@ class TXEpgChannelContainer {
  * @classdesc This class implements an interface of a DTS-provider element
  */
 class TXEpgDTSProvider {
-  /** @property {object} */
-  #_content;// = null;
-  /** @property {object} */
-  #_options;// = null;
+  /** @type {object} */
+  #_content;
+  /** @type {OPT_epgelsett_bs} */
+  #_options;
 
   /**
+   * Creates an instance of the DTS-provider element
    * @param {object} obj - host object
-   * @param {object} [opt] - options
-   * @param {object} [opt.parseOptions]
-   * @description Creates an instance of the DTS-provider element
+   * @param {OPT_epgelsett_bs} [opt] - options
    */
   constructor(obj, opt) {
     // load content
     const _content = isPlainObject(obj) ? obj : {};
     // load options
-    let _options = isPlainObject(opt) ? opt : {};
+    const _options = __evalXMLBaseNodeSettings(opt);
     let {
       parseOptions,
     } = _options;
-    if (!(parseOptions instanceof TXmlContentParseOptions)) {
-      parseOptions = new TXmlContentParseOptions(parseOptions);
-      _options.parseOptions = parseOptions;
-    };
     // save content source
     this.#_content = _content;
     // save options
@@ -1077,7 +1333,7 @@ class TXEpgDTSProvider {
 
   /**
    * Contains a dtstype ID
-   * @property {number}
+   * @type {number}
    */
   get dtstype() {
     const item = getXObjElement(this.#_content, XEPG_DTSINFO_ETAG_NAME);
@@ -1092,7 +1348,7 @@ class TXEpgDTSProvider {
 
   /**
    * Contains a TZ-offset
-   * @property {number}
+   * @type {number}
    */
   get curDocTZ() {
     const tz = convTZStringToValue(
@@ -1109,15 +1365,17 @@ class TXEpgDTSProvider {
         XEPG_DOCTZ_ETAG_NAME,
         { force: true },
       );
-      if (item) writeXObjParam(item, _value);
+      if (item) {
+        writeXObjParam(item, _value, defParseOptions.settings.textKey);
+      };
     };
   }
 
   /**
+   * Tries to set a `DTS`-type
    * @since 0.0.22
    * @property {(number|string)} value - dtstype ID
    * @returns {boolean}
-   * @description Tries to set a `DTS`-type
    */
   setType(value) {
     let { index, name } = getDTSysDescr(value);
@@ -1132,10 +1390,10 @@ class TXEpgDTSProvider {
         let curItem = insertXObjElement(item, 'value', { force: true });
         if (
           curItem
-          && writeXObjParam(curItem, index)
+          && writeXObjParam(curItem, index, defParseOptions.settings.textKey)
           && (curItem = insertXObjElement(item, 'name', { force: true }))
         ) {
-          isSucceed = writeXObjParam(curItem, name);
+          isSucceed = writeXObjParam(curItem, name, defParseOptions.settings.textKey);
         };
       };
     };
@@ -1148,33 +1406,28 @@ class TXEpgDTSProvider {
  * @classdesc This class implements an interface of a EPG-header element
  */
 class TXEpgHeaderContainer {
-  /** @property {Object} */
-  #_host;// = null;
-  /** @property {Object} */
-  #_options;// = null;
-  /** @property {TXmlContentParseOptions} */
-  #_parseOptions;// = null;
-  /** @property {TXEpgDTSProvider} */
-  #_dtsProv;// = null;
+  /** @type {Object} */
+  #_host;
+  /** @type {OPT_epgelsett_bs} */
+  #_options;
+  /** @type {TXmlContentParseOptions} */
+  #_parseOptions;
+  /** @type {TXEpgDTSProvider} */
+  #_dtsProv;
 
   /**
-   * @param {object} obj
-   * @param {object} [opt] - options
-   * @param {object} [opt.parseOptions]
-   * @description Creates an instance of the EPG-header element
+   * Creates an instance of the EPG-header element
+   * @param {object} obj - host element
+   * @param {OPT_epgelsett_bs} [opt] - options
    */
   constructor(obj, opt) {
     // load content
     const _host = isPlainObject(obj) ? obj : {};
     // load options
-    const _options = isPlainObject(opt) ? opt : {};
+    const _options = __evalXMLBaseNodeSettings(opt);
     let {
       parseOptions,
     } = _options;
-    if (!(parseOptions instanceof TXmlContentParseOptions)) {
-      parseOptions = new TXmlContentParseOptions(parseOptions);
-      _options.parseOptions = parseOptions;
-    };
     // save options
     this.#_options = _options;
     // save parser options
@@ -1187,7 +1440,7 @@ class TXEpgHeaderContainer {
 
   /**
    * Returns a `TXEpgDTSProvider` instance
-   * @property {TXEpgDTSProvider}
+   * @type {TXEpgDTSProvider}
    * @readonly
    */
   get dts() {
@@ -1196,7 +1449,7 @@ class TXEpgHeaderContainer {
 
   /**
    * Contains a dtstype ID
-   * @property {number}
+   * @type {number}
    * @todo [since v0.0.22] becomes readonly
    */
   get dtstype() {
@@ -1209,7 +1462,7 @@ class TXEpgHeaderContainer {
 
   /**
    * Contains a TZ-offset
-   * @property {number}
+   * @type {number}
    * @todo [since v0.0.22] becomes readonly
    */
   get curDocTZ() {
@@ -1244,9 +1497,10 @@ class TXEpgHeaderContainer {
 
   /**
    * Returns a `TXEpgProviderContainer` instance
-   * @property {?TXEpgProviderContainer}
+   * @type {?TXEpgProviderContainer}
    * @readonly
    * @deprecated
+   * @todo \[since `v0.0.22`] deprecated. Use `TXEpgHeaderContainer.provider`
    */
   get Provider() {
     return this.provider;
@@ -1255,7 +1509,7 @@ class TXEpgHeaderContainer {
   /**
    * Returns a `TXEpgProviderContainer` instance
    * @since 0.0.22
-   * @property {?TXEpgProviderContainer}
+   * @type {?TXEpgProviderContainer}
    * @readonly
    */
   get provider() {
@@ -1270,7 +1524,7 @@ class TXEpgHeaderContainer {
   /**
    * Returns a `TXEpgChannelContainer` instance
    * @since 0.0.22
-   * @property {?TXEpgChannelContainer}
+   * @type {?TXEpgChannelContainer}
    * @readonly
    */
   get channel() {
@@ -1278,8 +1532,8 @@ class TXEpgHeaderContainer {
   }
 
   /**
+   * Returns a document creation date as a timestamp
    * @returns {number}
-   * @description Returns a document creation date as a timestamp
    */
   getDocumentDT() {
     let dt_str = _getXmlChildElementParam(this.#_host, XEPG_DOCDTO_ETAG_NAME).trim();
@@ -1291,8 +1545,8 @@ class TXEpgHeaderContainer {
   }
 
   /**
+   * Sets a document creation date to a current system time
    * @returns {void}
-   * @description Sets a document creation date to a current system time
    */
   setDocumentDT() {
     let dt_str = convDTValueToString(Date.now(), this.dtstype, this.curDocTZ);
@@ -1301,12 +1555,14 @@ class TXEpgHeaderContainer {
       XEPG_DOCDTO_ETAG_NAME,
       { force: true },
     );
-    if (item) writeXObjParam(item, dt_str);
+    if (item) {
+      writeXObjParam(item, dt_str, defParseOptions.settings.textKey);
+    };
   }
 
   /**
+   * Returns a document expire date as a timestamp
    * @returns {number}
-   * @description Returns a document expire date as a timestamp
    */
   getDocumentEDT() {
     let dt_str = _getXmlChildElementParam(this.#_host, XEPG_DOCDTE_ETAG_NAME).trim();
@@ -1318,9 +1574,9 @@ class TXEpgHeaderContainer {
   }
 
   /**
+   * Sets a document expire date to a given time
    * @param {any} value - document expire date
    * @returns {void}
-   * @description Sets a document expire date to a given time
    */
   setDocumentEDT(value) {
     // TODO: check if value is a DateTime-string
@@ -1330,12 +1586,14 @@ class TXEpgHeaderContainer {
       XEPG_DOCDTE_ETAG_NAME,
       { force: true },
     );
-    if (item) writeXObjParam(item, dt_str);
+    if (item) {
+      writeXObjParam(item, dt_str, defParseOptions.settings.textKey);
+    };
   }
 
   /**
+   * Returns a channel info
    * @returns {xepgChnInfoDesc}
-   * @description Returns a channel info
    */
   getChannelInfo() {
     return this.channel.getInfo();
@@ -1347,7 +1605,7 @@ class TXEpgHeaderContainer {
    * @description Sets a channel info
    * @deprecated
    * @todo [since v0.0.21] deprecate use of `obj`-param as array
-   * @todo [since v0.0.22] deprecated
+   * @todo [since v0.0.22] deprecated. Use `TXEpgChannelContainer.setInfo`
    */
   setChannelInfo(obj) {
     let _obj = obj;
@@ -1360,20 +1618,22 @@ class TXEpgHeaderContainer {
   }
 
   /**
+   * Returns a provider info
    * @returns {?xepgProvInfoDesc}
-   * @description Returns a provider info
    */
-  getProviderInfo(){
+  getProviderInfo() {
     const docProv = this.provider;
     return docProv ? docProv.getInfo() : null;
   }
 
   /**
+   * Sets a provider info
    * @param {xepgProvInfoDesc} obj - provider info descriptor
    * @returns {void}
-   * @description Sets a provider info
+   * @deprecated
+   * @todo \[since `v0.0.24`] deprecated. Use `TXEpgProviderContainer.setInfo`
    */
-  setProviderInfo(obj){
+  setProviderInfo(obj) {
     if (isArray(obj) || isObject(obj)) {
       let docProv = this.provider;
       if (!docProv) {
@@ -1385,37 +1645,59 @@ class TXEpgHeaderContainer {
   }
 
   /**
-   * @returns {string}
+   * Returns an instance content as a string in an XML-format.
    * @since v0.0.20
-   * @description Returns an instance content as a string in an XML-format.
+   * @returns {string}
    */
   saveToXMLString() {
     const options = this.#_parseOptions.js2xml;
     options.ignoreDocType = true;
     options.ignoreDeclaration = true;
-    const content = { [`${XEPG_HEADER_ETAG_NAME}`]: this.#_host };
-    let result = '';
-    try {
-      result = xmlParser.js2xml(content, options);
-    } catch (err) {
-      //console.log('CHECK: TXEpgHeaderContainer.saveToXMLString() => Error => '+err);
-      result = '';
-      //throw err;
-    };
-    return result;
+    return serializeXObjToXMLString(
+      this.#_host,
+      options,
+      XEPG_HEADER_ETAG_NAME,
+    );
+  }
+
+  /**
+   * Loads an element content from a string.
+   * @since v0.0.24
+   * @param {string} xmlString - some content
+   * @returns {boolean}
+   * @throws {Error}
+   * @experimental
+   */
+  loadFromXMLString(xmlString) {
+    const options = this.#_parseOptions.xml2js;
+    options.ignoreDocType = true;
+    options.ignoreDeclaration = true;
+    return deserializeXObjFromXMLString(
+      this.#_host,
+      options,
+      xmlString,
+      XEPG_HEADER_ETAG_NAME,
+    );
   }
 
 };
 
 /**
+ * A fs ops description.
  * @typedef {Object} fsoDescr
  * @property {boolean} isERR - flag
  * @property {number} [errCode] - error code
  * @property {string} errEvent - event ID
- * @property {string} errMsg - event message
- * @property {string} source - path to file
- * @property {any} content - file content
- * @description A fs ops description.
+ * @property {string} [errMsg] - event message
+ * @property {string} [source] - path to file
+ * @property {any} [content] - file content
+ */
+
+/**
+ * An options set for `TXEpgContentProvider`-class
+ * @typedef {Object} OPT_epgcpsett
+ * @property {TXmlContentParseOptions} [parseOptions] - parser options
+ * @property {boolean} [autoBindRoot] - <*deprecated*>
  */
 
 /**
@@ -1423,30 +1705,25 @@ class TXEpgHeaderContainer {
  *            that manages a content of a XEPG-document
  */
 class TXEpgContentProvider {
-  /** @property {Object} */
-  #_content;// = null;
-  /** @property {Object} */
-  #_options;// = null;
-  /** @property {?TXmlContentParseOptions} */
-  #_parseOptions;// = null;
+  /** @type {Object} */
+  #_content;
+  /** @type {OPT_epgcpsett} */
+  #_options;
+  /** @type {TXmlContentParseOptions} */
+  #_parseOptions;
 
   /**
-   * @param {object} [opt] - options
-   * @param {object} [opt.parseOptions]
-   * @param {boolean} [opt.autoBindRoot] - <*reserved*> ([?] - deprecate)
-   * @description Creates an instance of the XEPG-content provider
+   * Creates an instance of the XEPG-content provider
+   * @param {OPT_epgcpsett} [opt] - options
    */
   constructor(opt) {
     // load options
-    const _options = isPlainObject(opt) ? opt : {};
+    const _options = __evalXMLBaseNodeSettings(opt);
+    /** @type {OPT_epgcpsett} */
     let {
       parseOptions,
       autoBindRoot, // <*reserved*> ([?] - deprecate)
     } = _options;
-    if (!(parseOptions instanceof TXmlContentParseOptions)) {
-      parseOptions = new TXmlContentParseOptions(parseOptions);
-      _options.parseOptions = parseOptions;
-    };
     if (typeof autoBindRoot !== 'boolean') autoBindRoot = false;
     // save options
     //_options.autoBindRoot = autoBindRoot; //* // TODO:
@@ -1477,7 +1754,12 @@ class TXEpgContentProvider {
     if (!docRoot) {
       docRoot = insertXObjElement(_content, XEPG_ROOT_ETAG_NAME);
       if (docRoot) {
-        writeXObjAttr(docRoot, `xmlns:${XEPG_DEF_NS_NAME}`, XEPG_DEF_NS_PATH);
+        writeXObjAttr(
+          docRoot,
+          `xmlns:${XEPG_DEF_NS_NAME}`,
+          XEPG_DEF_NS_PATH,
+          defParseOptions.settings.attributesKey,
+        );
       };
     };
     return isPlainObject(docRoot) ? docRoot : null;
@@ -1543,23 +1825,19 @@ class TXEpgContentProvider {
 
   /**
    * Returns a `TXEpgHeaderContainer` instance
-   * @property {?TXEpgHeaderContainer}
+   * @type {?TXEpgHeaderContainer}
    * @readonly
    * @deprecated
+   * @todo \[since `v0.0.22`] deprecated. Use `TXEpgContentProvider.header`
    */
   get Header() {
-    const docHdr = this.#_getHdr();
-    return (
-      docHdr
-      ? new TXEpgHeaderContainer(docHdr, this.#_options)
-      : null
-    );
+    return this.header;
   }
 
   /**
    * Returns a `TXEpgHeaderContainer` instance
    * @since 0.0.22
-   * @property {?TXEpgHeaderContainer}
+   * @type {?TXEpgHeaderContainer}
    * @readonly
    */
   get header() {
@@ -1573,19 +1851,19 @@ class TXEpgContentProvider {
 
   /**
    * Returns a `TXEpgProviderContainer` instance
-   * @property {?TXEpgProviderContainer}
+   * @type {?TXEpgProviderContainer}
    * @readonly
    * @deprecated
+   * @todo \[since `v0.0.22`] deprecated. Use `TXEpgContentProvider.provider`
    */
   get Provider() {
-    const docHdr = this.header;
-    return docHdr ? docHdr.provider : null;
+    return this.provider;
   }
 
   /**
    * Returns a `TXEpgProviderContainer` instance
    * @since 0.0.22
-   * @property {?TXEpgProviderContainer}
+   * @type {?TXEpgProviderContainer}
    * @readonly
    */
   get provider() {
@@ -1595,7 +1873,7 @@ class TXEpgContentProvider {
 
   /**
    * Returns a `TXEpgDTSProvider` instance
-   * @property {?TXEpgDTSProvider}
+   * @type {?TXEpgDTSProvider}
    * @readonly
    */
   get dts() {
@@ -1611,10 +1889,22 @@ class TXEpgContentProvider {
 
   /**
    * Returns a `TXEpgSchedulesList` instance
-   * @property {TXEpgSchedulesList}
+   * @type {TXEpgSchedulesList}
    * @readonly
+   * @deprecated
+   * @todo \[since `v0.0.24`] deprecated. Use `TXEpgContentProvider.schedules`
    */
   get SchedulesList() {
+    return this.schedules;
+  }
+
+  /**
+   * Returns a `TXEpgSchedulesList` instance
+   * @since 0.0.24
+   * @type {TXEpgSchedulesList}
+   * @readonly
+   */
+  get schedules() {
     const _options = this.#_options;
     const docBody = this.#_getBody();
     if (docBody && isArray(docBody[XEPG_SCHED_ETAG_NAME])) {
@@ -1669,8 +1959,8 @@ class TXEpgContentProvider {
   }
 
   /**
+   * Returns a document content as a string in an XML-format.
    * @returns {string}
-   * @description Returns a document content as a string in an XML-format.
    */
   saveToXMLString() {
     let result = '';
@@ -1684,11 +1974,11 @@ class TXEpgContentProvider {
   }
 
   /**
+   * Saves a document content to a file.
    * @param {string} source - a path to a file
    * @returns {Promise<fsoDescr, Error>}
    * @throws {Error}
    * @async
-   * @description Saves a document content to a file.
    */
   saveToFile(source) {
     /**/// main part that return promise as a result
@@ -1725,9 +2015,9 @@ class TXEpgContentProvider {
   }
 
   /**
+   * Saves a document content to a file.
    * @param {string} source - path to a file
    * @returns {fsoDescr}
-   * @description Saves a document content to a file.
    */
   saveToFileSync(source) {
     /** @type {fsoDescr} */
@@ -1754,11 +2044,11 @@ class TXEpgContentProvider {
   }
 
   /**
+   * Loads a document content from a string.
+   * @since 0.0.18
    * @param {string} xmlString - a document content in XML-format
    * @returns {boolean}
    * @throws {Error}
-   * @since 0.0.18
-   * @description Loads a document content from a string.
    */
   loadFromXMLString(xmlString) {
     let isSUCCEED = false;
@@ -1791,23 +2081,16 @@ class TXEpgContentProvider {
   }
 
   /**
-   * @deprecated
-   */
-  loadFromString(...args){
-    return this.loadFromXMLString(...args);
-  }
-
-  /**
+   * Loads a document content from a file.
    * @param {string} source - path to a file
    * @returns {Promise<fsoDescr, Error>}
    * @throws {Error}
    * @async
-   * @description Loads a document content from a file.
    */
   loadFromFile(source) {
     /**/// main part that return promise as a result
     return new Promise((resolve, reject) => {
-      loadFile(source).then(data => {
+      loadFromFile(source).then(data => {
         if (!data.isERR) {
           if (data.content !== '') {
             if (this.loadFromXMLString(data.content)) {
@@ -1833,12 +2116,12 @@ class TXEpgContentProvider {
   }
 
   /**
+   * Loads a document content from a file.
    * @param {string} source - path to a file
    * @returns {fsoDescr}
-   * @description Loads a document content from a file.
    */
   loadFromFileSync(source) {
-    const data = loadFileSync(source);
+    const data = loadFromFileSync(source);
     if (!data.isERR) {
       if (data.content !== '') {
         if (this.loadFromXMLString(data.content)) {
@@ -1868,6 +2151,15 @@ class TXEpgContentProvider {
 
 // === module exports block ===
 
+module.exports.XEPG_DEF_PROVIDER_NAME = XEPG_DEF_PROVIDER_NAME;
+module.exports.XEPG_DEF_PROVIDER_VER = XEPG_DEF_PROVIDER_VER;
+module.exports.XEPG_DEF_DOCUMENT_TYPE = XEPG_DEF_DOCUMENT_TYPE;
+module.exports.XEPG_DEF_DOCUMENT_SCHEMA = XEPG_DEF_DOCUMENT_SCHEMA;
+
+module.exports.readAsTagName = readAsTagName;
+module.exports.readAsAttrName = readAsAttrName;
+module.exports.valueToElementID = valueToElementID;
+
 module.exports.TXEpgDTSProvider = TXEpgDTSProvider;
 module.exports.TXEpgScheduleItem = TXEpgScheduleItem;
 module.exports.TXEpgSchedulesList = TXEpgSchedulesList;
@@ -1875,11 +2167,3 @@ module.exports.TXEpgProviderContainer = TXEpgProviderContainer;
 module.exports.TXEpgChannelContainer = TXEpgChannelContainer;
 module.exports.TXEpgHeaderContainer = TXEpgHeaderContainer;
 module.exports.TXEpgContentProvider = TXEpgContentProvider;
-
-module.exports.XEPG_DEF_PROVIDER_NAME = XEPG_DEF_PROVIDER_NAME;
-module.exports.XEPG_DEF_PROVIDER_VER = XEPG_DEF_PROVIDER_VER;
-module.exports.XEPG_DEF_DOCUMENT_TYPE = XEPG_DEF_DOCUMENT_TYPE;
-module.exports.XEPG_DEF_DOCUMENT_SCHEMA = XEPG_DEF_DOCUMENT_SCHEMA;
-
-/** @deprecated */
-module.exports.TXepgDTSProvider = TXEpgDTSProvider;