@ygracs/xepg-lib-js 0.0.21 → 0.0.23

package/lib/xepgdoc-lib.js

@@ -1,18 +1,19 @@
-// [v0.1.081-20250227]
+// [v0.2.106-20250428]
 
 // === 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');
 
 const {
   convValueToTZString, convTZStringToValue,
+  tryDTValue,
 } = require('@ygracs/dtf-lib-js');
 
 const {
@@ -21,15 +22,19 @@ 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 insertXObjElement = xObj.insertXObjElement;
-const getXObjElement = xObj.getXObjElement;
+const {
+  TXmlContentParseOptions,
+  getXObjElement,
+  insertXObjElement,
+  writeXObjParam,
+  writeXObjAttr,
+} = xObj;
 
 // === module extra block (helper functions) ===
 
@@ -41,37 +46,52 @@ 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) ===
  */
 
-function _getXmlChildElementParam(obj, elem){
-  const child = obj ? getXObjElement(obj, elem) : null;
+/**
+ * @param {object} obj - element
+ * @param {string} name - child element name
+ * @returns {string}
+ * @inner
+ */
+function _getXmlChildElementParam(obj, name) {
+  const child = obj ? getXObjElement(obj, name) : null;
   return child ? readXObjParam(child) : '';
 };
 
-function writeXEpgDocDeclSection(obj, opt){
+/**
+ * @param {object} obj - element
+ * @returns {number}
+ * @inner
+ */
+function _getDTSTypeValueForXObj(obj) {
+  const result = valueToIndex(
+    _getXmlChildElementParam(obj, 'value')
+  );
+  return chkDTSysID(result) ? result : 0; //-1; // // TODO: [?]
+};
+
+/**
+ * @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);
   };
 };
 
@@ -81,6 +101,11 @@ function writeXEpgDocDeclSection(obj, opt){
  * (* constant definitions *)
  */
 
+/**
+ * A list of a document schema version supported by a library
+ */
+const ALLOWED_XEPG_DOCUMENT_SCHEMA = [ '0.2' ];
+
 const XEPG_ROOT_ETAG_NAME = 'epgdoc';
 const XEPG_DEF_NS_NAME = 'tvp';
 const XEPG_DEF_NS_PATH = 'urn:e-doc:epg-doc:xepg';
@@ -106,9 +131,9 @@ const XEPG_SCHEDDESC_ETAG_NAME = `${XEPG_DEF_NS_NAME}:desc`;
 const XEPG_XML_DOC_VERSION = '1.0';
 const XEPG_DEF_ENCODING_VALUE = 'UTF-8';
 const XEPG_DEF_DOCUMENT_TYPE = 'xepg';
-const XEPG_DEF_DOCUMENT_SCHEMA = '0.2';
+const XEPG_DEF_DOCUMENT_SCHEMA = ALLOWED_XEPG_DOCUMENT_SCHEMA[0];
 const XEPG_DEF_PROVIDER_NAME = 'xepg-lib-js';
-const XEPG_DEF_PROVIDER_VER = '0.0.15';
+const XEPG_DEF_PROVIDER_VER = '0.0.21';
 
 const defXEpgDocOptions = {
   xmlns_xepg_pref: XEPG_DEF_NS_NAME,
@@ -135,6 +160,75 @@ const defParseOptions = new TXmlContentParseOptions();
  * (* function definitions *)
  */
 
+/**
+ * @since v0.0.23
+ * @function readAsTagName
+ * @param {any} value - some value
+ * @returns {string}
+ * @description Tries to convert a given value to a valid tag name
+ *              of an XML-element.
+ */
+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;
+};
+
+/**
+ * @since v0.0.23
+ * @function readAsAttrName
+ * @param {any} value - some value
+ * @returns {string}
+ * @description Tries to convert a given value to a valid name
+ *              of an XML-attribute.
+ */
+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;
+};
+
+/**
+ * @since v0.0.23
+ * @function valueToElementID
+ * @param {any} value - some value
+ * @returns {string}
+ * @description Tries to convert a given value to a valid identifier
+ *              suitable as a value for an "ID-attribute" of an XML-element.
+ */
+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 *)
  */
@@ -149,28 +243,294 @@ const defParseOptions = new TXmlContentParseOptions();
  * @description A schedule info descriptor
  */
 
+/**
+ * @typedef {Object} OPT_epgelsett_bs
+ * @property {TXmlContentParseOptions} [parseOptions] - parser options
+ * @description An XEPG-element options set (base)
+ */
+
+/**
+ * @typedef {Object} OPT_epgelsett_ex
+ * @property {TXmlContentParseOptions} [parseOptions] - parser options
+ * @property {object} [opt.dts_src]
+ * @property {object} [opt.tz_src]
+ * @description An XEPG-element options set (extend)
+ */
+
+/**
+ * @since 0.0.22
+ * @classdesc This class implements an interface of a EPG-schedule element
+ */
+class TXEpgScheduleItem {
+  /** @type {object} */
+  #_host;// = null;
+  /** @type {OPT_epgelsett_ex} */
+  #_options;// = null;
+  /** @type {TXmlContentParseOptions} */
+  #_parseOptions;// = null;
+  /** @type {?object} */
+  #_dts_src = null;
+  /** @type {?object} */
+  #_tz_src = null;
+
+  /**
+   * @param {object} obj - host object
+   * @param {OPT_epgelsett_ex} [opt] - options
+   * @description Creates an instance of the EPG-schedule element
+   */
+  constructor(obj, opt) {
+    // 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;
+    };
+    if (!isPlainObject(dts_src)) dts_src = null;
+    if (!isPlainObject(tz_src)) tz_src = null;
+    // save content source
+    this.#_host = _host;
+    // save options
+    this.#_options = _options;
+    // save parser options
+    this.#_parseOptions = parseOptions;
+    // save refs to a time source priveders
+    this.#_dts_src = dts_src;
+    this.#_tz_src = tz_src;
+  }
+
+  /**
+   * Contains a dtstype ID
+   * @type {number}
+   * @readonly
+   */
+  get dtstype() {
+    return _getDTSTypeValueForXObj(this.#_dts_src);
+  }
+
+  /**
+   * Contains a TZ-offset
+   * @type {number}
+   * @readonly
+   */
+  get curDocTZ() {
+    return (
+      this.#_tz_src
+      ? convTZStringToValue(readXObjParam(this.#_tz_src).trim())
+      : 0
+    );
+  }
+
+  /**
+   * Contains a schedule start time as a timestamp
+   * @type {number}
+   * @readonly
+   */
+  get time() {
+    return convStringToDTValue(
+      _getXmlChildElementParam(this.#_host, XEPG_SCHEDTIME_ETAG_NAME).trim(),
+      this.dtstype, this.curDocTZ
+    );
+  }
+
+  /**
+   * Contains a schedule title
+   * @type {string}
+   * @readonly
+   */
+  get title() {
+    return _getXmlChildElementParam(this.#_host, XEPG_SCHEDTITL_ETAG_NAME).trim();
+  }
+
+  /**
+   * Contains a schedule category
+   * @type {string}
+   * @readonly
+   */
+  get category() {
+    return _getXmlChildElementParam(this.#_host, XEPG_SCHEDCAT_ETAG_NAME).trim();
+  }
+
+  /**
+   * Contains a schedule rating value (aka pcmark)
+   * @type {number}
+   * @readonly
+   */
+  get rating() {
+    return readAsNumber(
+      _getXmlChildElementParam(this.#_host, XEPG_SCHEDPMARK_ETAG_NAME), 0
+    );
+  }
+
+  /**
+   * Contains a schedule description
+   * @type {string}
+   * @readonly
+   */
+  get descr() {
+    return _getXmlChildElementParam(this.#_host, XEPG_SCHEDDESC_ETAG_NAME);
+  }
+
+  /**
+   * @returns {xepgShedInfoDesc}
+   * @description Returns a schedule info item descriptor
+   */
+  getInfo() {
+    const {
+      time,
+      title,
+      category: cat,
+      rating: pcmark,
+      descr,
+    } = this;
+    return {
+      time,
+      title,
+      cat,
+      pcmark,
+      descr,
+    };
+  }
+
+  /**
+   * @param {(number|string|Date)} value - some time value
+   * @returns {boolean}
+   * @description Sets a schedule start time.
+   */
+  setTime(value) {
+    let { isSucceed, value: dtValue } = tryDTValue(value);
+    let result = false;
+    if (isSucceed) {
+      dtValue = convDTValueToString(dtValue, this.dtstype, this.curDocTZ);
+      if (dtValue !== '') {
+        const opt = { force: true };
+        const item = insertXObjElement(this.#_host, XEPG_SCHEDTIME_ETAG_NAME, opt);
+        if (item) {
+          result = writeXObjParam(item, dtValue, defParseOptions.settings.textKey);
+        };
+      };
+    };
+    return result;
+  }
+
+  /**
+   * @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(), defParseOptions.settings.textKey);
+      };
+    };
+    return result;
+  }
+
+  /**
+   * @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(), defParseOptions.settings.textKey);
+      };
+    };
+    return result;
+  }
+
+  /**
+   * @param {(number|string)} value - some value
+   * @returns {boolean}
+   * @description Sets a schedule rating value.
+   */
+  setRating(value) {
+    const _value = valueToIndex(value);
+    let result = false;
+    if (_value !== -1) {
+      const opt = { force: true };
+      const item = insertXObjElement(this.#_host, XEPG_SCHEDPMARK_ETAG_NAME, opt);
+      if (item) {
+        result = writeXObjParam(item, _value, defParseOptions.settings.textKey);
+      };
+    };
+    return result;
+  }
+
+  /**
+   * @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(), defParseOptions.settings.textKey);
+      };
+    };
+    return result;
+  }
+
+  /**
+   * @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;
+  }
+
+};
+
 /**
  * @classdesc This class implements an interface of a EPG-schedules list
  */
 class TXEpgSchedulesList {
-  /** @property {object[]} */
+  /** @type {object[]} */
   #_content;// = null;
-  /** @property {object} */
+  /** @type {OPT_epgelsett_ex} */
   #_options;// = null;
-  /** @property {?object} */
+  /** @type {?object} */
   #_dts_src = null;
-  /** @property {?object} */
+  /** @type {?object} */
   #_tz_src = null;
 
   /**
    * @param {any[]} obj - list of an elements
-   * @param {object} [opt] - options
-   * @param {?object} [opt.dts_src]
-   * @param {?object} [opt.tz_src]
+   * @param {OPT_epgelsett_ex} [opt] - options
    * @description Creates an instance of the schedules list
    */
   constructor(obj, opt) {
     const _content = isArray(obj) ? obj : [];
+    /** @type {OPT_epgelsett_ex} */
     const _options = isPlainObject(opt) ? opt : {};
     let { dts_src, tz_src } = _options;
     if (!isPlainObject(dts_src)) dts_src = null;
@@ -198,31 +558,25 @@ class TXEpgSchedulesList {
 
   /**
    * Contains a quantity of a schedules
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get schedQty() {
     return this.#_content.length;
   }
 
-  // will deprecate
-  //get SchedulesQty(){ return this.#_content.length; }
-
   /**
    * Contains a dtstype ID
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get dtstype() {
-    let result = valueToIndex(
-      _getXmlChildElementParam(this.#_dts_src, 'value')
-    );
-    return chkDTSysID(result) ? result : 0; //-1; // // TODO: [?]
+    return _getDTSTypeValueForXObj(this.#_dts_src);
   }
 
   /**
    * Contains a TZ-offset
-   * @property {number}
+   * @type {number}
    * @readonly
    */
   get curDocTZ() {
@@ -255,15 +609,17 @@ class TXEpgSchedulesList {
    * @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
    */
   chkScheduleIndex(value) {
     return this.chkIndex(value);
   }
 
   /**
+   * @since 0.0.20
    * @param {(number|string)} value - index of some element
    * @returns {boolean}
-   * @since 0.0.18
    * @description Checks whether a given value is a valid index
    *              and it fits the index range of an instance
    */
@@ -273,37 +629,32 @@ class TXEpgSchedulesList {
   }
 
   /**
+   * @since 0.0.22
    * @param {(number|string)} index - index of some element
-   * @returns {xepgShedInfoDesc}
+   * @returns {?TXEpgScheduleItem}
+   * @description Returns a schedule element addressed by a given index
+   */
+  schedule(index) {
+    const curObj = this.#_getItem(index);
+    let item = null;
+    if (isPlainObject(curObj)) {
+      item = new TXEpgScheduleItem(curObj, {
+        dts_src: this.#_dts_src,
+        tz_src: this.#_tz_src,
+      });
+    };
+    return item;
+  }
+
+  /**
+   * @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) {
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => was called...');
-    const curObj = this.#_getItem(index);
-    let tmpObj = {};
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+']');
-    //console.log('TXEpgSchedulesList => getScheduleInfo('+index+') => '+JSON.stringify(curObj, null, 2));
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+'] - [time]');
-    tmpObj.time = convStringToDTValue(
-      _getXmlChildElementParam(curObj, XEPG_SCHEDTIME_ETAG_NAME).trim(),
-      this.dtstype, this.curDocTZ
-    );
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+'] - [title]');
-    tmpObj.title = _getXmlChildElementParam(curObj, XEPG_SCHEDTITL_ETAG_NAME).trim();
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+'] - [category]');
-    tmpObj.cat = _getXmlChildElementParam(curObj, XEPG_SCHEDCAT_ETAG_NAME).trim();
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+'] - [pcmark]');
-    tmpObj.pcmark = readAsNumberEx(
-      _getXmlChildElementParam(curObj, XEPG_SCHEDPMARK_ETAG_NAME), 0
-    );
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => index:['+index+'] - [description]');
-    tmpObj.descr = _getXmlChildElementParam(curObj, XEPG_SCHEDDESC_ETAG_NAME);
-    //console.log('TXEpgSchedulesList => getScheduleInfo('+index+') => '+JSON.stringify(curObj, null, 2));
-    //console.log('TXEpgSchedulesList => getScheduleInfo('+index+') => '+JSON.stringify(tmpObj, null, 2));
-    // TODO: wrap tmpObj into container object
-    //console.log('TXEpgSchedulesList => getScheduleInfo() => was left...');
-    return tmpObj;
+    const obj = this.schedule(index);
+    return obj ? obj.getInfo() : null;
   }
 
   /**
@@ -341,24 +692,24 @@ class TXEpgSchedulesList {
  * @classdesc This class implements an interface of a EPG-provider element
  */
 class TXEpgProviderContainer {
-  /** @property {Object} */
+  /** @type {Object} */
   #_host;// = null;
-  /** @property {Object} */
+  /** @type {OPT_epgelsett_bs} */
   #_options;// = null;
-  /** @property {TXmlContentParseOptions} */
+  /** @type {TXmlContentParseOptions} */
   #_parseOptions;// = null;
-  /** @property {?TXEpgDTSProvider} */
+  /** @type {?TXEpgDTSProvider} */
 
   /**
-   * @param {object} obj
-   * @param {object} [opt] - options
-   * @param {object} [opt.parseOptions]
+   * @param {object} obj - host object
+   * @param {OPT_epgelsett_bs} [opt] - options
    * @description Creates an instance of the EPG-provider element
    */
   constructor(obj, opt) {
     // load content
     const _host = isPlainObject(obj) ? obj : {};
     // load options
+    /** @type {OPT_epgelsett_bs} */
     const _options = isPlainObject(opt) ? opt : {};
     let {
       parseOptions,
@@ -391,7 +742,7 @@ class TXEpgProviderContainer {
 
   /**
    * Contains a provider name
-   * @property {string}
+   * @type {string}
    */
   get name() {
     return _getXmlChildElementParam(this.#_host, 'name').trim();
@@ -403,7 +754,7 @@ class TXEpgProviderContainer {
 
   /**
    * Contains a version of a provider
-   * @property {string}
+   * @type {string}
    */
   get version() {
     return _getXmlChildElementParam(this.#_host, 'version').trim();
@@ -413,13 +764,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();
@@ -429,13 +782,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();
@@ -445,144 +800,363 @@ 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);
+      };
     };
   }
 
   /**
    * @param {string} value - provider name
    * @returns {boolean}
-   * @description Sets a provider name
+   * @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, defParseOptions.settings.textKey);
+      };
+    };
+    return isSucceed;
+  }
+
+  /**
+   * @returns {xepgProvInfoDesc}
+   * @description Returns a provider info item
+   */
+  getInfo() {
+    return {
+      name: this.name,
+      version: this.version,
+      schema: this.schema,
+      doctype: this.doctype,
+    };
+  }
+
+  /**
+   * @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) {
+    if (!isObject(obj)) return;
+    let name = '';
+    let version = '';
+    let schema = '';
+    let doctype = '';
+    if (isArray(obj)) {
+      // // TODO: [!] deprecate
+      [ name, version, schema, doctype ] = obj;
+    } else {
+      if (typeof obj.name === 'string') {
+        ({ name, version, schema, doctype } = obj);
+      } else {
+        // // TODO: [?] deprecate
+        name = _getXmlChildElementParam(obj, 'name');
+        version = _getXmlChildElementParam(obj, 'version');
+        schema = _getXmlChildElementParam(obj, XEPG_DOCSCH_ETAG_NAME);
+        doctype = _getXmlChildElementParam(obj, XEPG_DOCTYP_ETAG_NAME);
+      };
+    };
+    name = typeof name === 'string' ? name.trim() : '';
+    version = typeof version === 'string' ? version.trim() : '';
+    schema = typeof schema === 'string' ? schema.trim() : '';
+    doctype = typeof doctype === 'string' ? doctype.trim() : '';
+    if (name === '') version = '';
+    this.setName(name);
+    this.version = version;
+    this.schema = schema;
+    this.doctype = doctype;
+  }
+
+  /**
+   * @param {(xepgProvInfoDesc|string[])} opt - options
+   * @returns {void}
+   * @description Sets an initial instance state
+   */
+  init(opt) {
+    let prov_opt = { ...defXEpgDocOptions.defProviderParam };
+    let name = '';
+    let version = '';
+    let schema = '';
+    let doctype = '';
+    const _options = isObject(opt) ? opt : {};
+    if (isArray(_options)) {
+      [ name, version, schema, doctype ] = _options;
+    } else {
+      ({ name, version, schema, doctype } = _options);
+    };
+    name = readAsString(name, { defValue: prov_opt.name, useTrim: true });
+    version = readAsString(version, { defValue: prov_opt.version, useTrim: true });
+    doctype = readAsString(doctype, { defValue: prov_opt.doctype, useTrim: true });
+    schema = readAsString(schema, { defValue: prov_opt.schema, useTrim: true });
+    this.name = name;
+    this.version = version;
+    this.schema = schema;
+    this.doctype = doctype;
+  }
+
+  /**
+   * @since v0.0.20
+   * @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_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;
+  }
+
+};
+
+/**
+ * @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 {
+  /** @type {object} */
+  #_host;// = null;
+  /** @type {OPT_epgelsett_bs} */
+  #_options;// = null;
+  /** @type {TXmlContentParseOptions} */
+  #_parseOptions;// = null;
+  /** @type {string} */
+  #_xepgSchema;// = null;
+
+  /**
+   * @param {object} obj - host object
+   * @param {OPT_epgelsett_bs} [opt] - options
+   * @description Creates an instance of the channel element
+   */
+  constructor(obj, opt) {
+    // load content
+    const _host = isPlainObject(obj) ? obj : {};
+    // load options
+    /** @type {OPT_epgelsett_bs} */
+    const _options = isPlainObject(opt) ? 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
+    this.#_options = _options;
+    // save parser options
+    this.#_parseOptions = parseOptions;
+    // save content source
+    this.#_host = _host;
+  }
+
+  /**
+   * Contains a channel ID
+   * @type {string}
+   * @readonly
+   */
+  get id() {
+    return _getXmlChildElementParam(this.#_host, XEPG_CHNID_ETAG_NAME).trim();
+  }
+
+  /**
+   * Contains a channel name
+   * @type {string}
+   */
+  get name() {
+    return _getXmlChildElementParam(this.#_host, XEPG_CHNNAME_ETAG_NAME).trim();
+  }
+
+  set name(value) {
+    if (typeof value === 'string' && this.id !== '') {
+      const item = insertXObjElement(
+        this.#_host,
+        XEPG_CHNNAME_ETAG_NAME,
+        { force: true },
+      );
+      if (item) {
+        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
+    };
+  }
+
+  /**
+   * Contains a channel Group ID
+   * @type {string}
+   */
+  get gid() {
+    return _getXmlChildElementParam(this.#_host, XEPG_CHNGID_ETAG_NAME).trim();
+  }
+
+  set gid(value) {
+    if (typeof value === 'string' && this.id !== '') {
+      const item = insertXObjElement(
+        this.#_host,
+        XEPG_CHNGID_ETAG_NAME,
+        { force: true },
+      );
+      if (item) {
+        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
+    };
+  }
+
+  /**
+   * Contains a channel source URL
+   * @type {string}
+   */
+  get url() {
+    return _getXmlChildElementParam(this.#_host, XEPG_CHNURL_ETAG_NAME).trim();
+  }
+
+  set url(value) {
+    if (typeof value === 'string' && this.id !== '') {
+      const item = insertXObjElement(
+        this.#_host,
+        XEPG_CHNURL_ETAG_NAME,
+        { force: true },
+      );
+      if (item) {
+        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+      };
+    };
+  }
+
+  /**
+   * @param {string} value - channel ID
+   * @returns {boolean}
+   * @description Tries to set a channel ID
    */
-  setName(value) {
+  setID(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);
+      const chnid = value.trim();
+      const item = insertXObjElement(
+        this.#_host,
+        XEPG_CHNID_ETAG_NAME,
+        { force: true },
+      );
+      if (item) {
+        isSucceed = writeXObjParam(item, chnid, defParseOptions.settings.textKey);
+      };
     };
     return isSucceed;
   }
 
   /**
-   * @returns {xepgProvInfoDesc}
-   * @description Returns a provider info item
+   * @returns {xepgChnInfoDesc}
+   * @description Returns a channel info
    */
   getInfo() {
+    const {
+      id: chnid,
+      name: chname,
+      gid: chngid,
+      url: srcurl,
+    } = this;
+    /** @type {xepgChnInfoDesc} */
     return {
-      name: this.name,
-      version: this.version,
-      schema: this.schema,
-      doctype: this.doctype,
+      chnid,
+      chname,
+      chngid,
+      srcurl,
     };
   }
 
   /**
-   * @param {(string[]|xepgProvInfoDesc)} obj - provider info descriptor
+   * @param {(string|xepgChnInfoDesc)} obj - channel info descriptor
    * @returns {void}
-   * @description Sets a provider info
-   * @todo [since v0.0.21] deprecate use of `obj`-param as array
+   * @description Sets a channel info
    */
   setInfo(obj) {
-    if (!isObject(obj)) return;
-    let name = '';
-    let version = '';
-    let schema = '';
-    let doctype = '';
-    if (isArray(obj)) {
-      // // TODO: [!] deprecate
-      [ name, version, schema, doctype ] = obj;
-    } else {
-      if (typeof obj.name === 'string') {
-        ({ name, version, schema, doctype } = obj);
+    let chnid = '';
+    let chname = '';
+    let chngid = '';
+    let srcurl = '';
+    if (isObject(obj)) {
+      ({ chnid } = obj);
+      if (typeof chnid === 'string') {
+        ({ chname, chngid, srcurl } = obj);
       } else {
         // // TODO: [?] deprecate
-        name = _getXmlChildElementParam(obj, 'name');
-        version = _getXmlChildElementParam(obj, 'version');
-        schema = _getXmlChildElementParam(obj, XEPG_DOCSCH_ETAG_NAME);
-        doctype = _getXmlChildElementParam(obj, XEPG_DOCTYP_ETAG_NAME);
+        chnid = _getXmlChildElementParam(obj, XEPG_CHNID_ETAG_NAME).trim();
+        chname = _getXmlChildElementParam(obj, XEPG_CHNNAME_ETAG_NAME).trim();
+        chngid = _getXmlChildElementParam(obj, XEPG_CHNGID_ETAG_NAME).trim();
+        srcurl = _getXmlChildElementParam(obj, XEPG_CHNURL_ETAG_NAME).trim();
       };
-    };
-    name = typeof name === 'string' ? name.trim() : '';
-    version = typeof version === 'string' ? version.trim() : '';
-    schema = typeof schema === 'string' ? schema.trim() : '';
-    doctype = typeof doctype === 'string' ? doctype.trim() : '';
-    if (name === '') version = '';
-    this.setName(name);
-    this.version = version;
-    this.schema = schema;
-    this.doctype = doctype;
-  }
-
-  /**
-   * @param {(xepgProvInfoDesc|string[])} opt - options
-   * @returns {void}
-   * @description Sets an initial instance state
-   */
-  init(opt) {
-    let prov_opt = { ...defXEpgDocOptions.defProviderParam };
-    let name = '';
-    let version = '';
-    let schema = '';
-    let doctype = '';
-    const _options = isObject(opt) ? opt : {};
-    if (isArray(_options)) {
-      [ name, version, schema, doctype ] = _options;
+    } else if (typeof obj === 'string') {
+      chnid = obj;
     } else {
-      ({ name, version, schema, doctype } = _options);
+      return;
     };
-    name = readAsString(name, { defValue: prov_opt.name, useTrim: true });
-    version = readAsString(version, { defValue: prov_opt.version, useTrim: true });
-    doctype = readAsString(doctype, { defValue: prov_opt.doctype, useTrim: true });
-    schema = readAsString(schema, { defValue: prov_opt.schema, useTrim: true });
-    this.name = name;
-    this.version = version;
-    this.schema = schema;
-    this.doctype = doctype;
-  }
-
-  /**
-   * @returns {string}
-   * @since v0.0.20
-   * @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_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;
+    chnid = typeof chnid === 'string' ? chnid.trim() : '';
+    if (chnid === '') {
+      chname = '';
+      chngid = '';
+      srcurl = '';
+    } else {
+      chname = typeof chname === 'string' ? chname.trim() : '';
+      chngid = typeof chngid === 'string' ? chngid.trim() : '';
+      srcurl = typeof srcurl === 'string' ? srcurl.trim() : '';
     };
-    return result;
+    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, text_key);
+    item = insertXObjElement(_host, XEPG_CHNNAME_ETAG_NAME, { force: true });
+    if (item) writeXObjParam(item, chname, text_key);
+    item = insertXObjElement(_host, XEPG_CHNGID_ETAG_NAME, { force: true });
+    if (item) writeXObjParam(item, chngid, text_key);
+    item = insertXObjElement(_host, XEPG_CHNURL_ETAG_NAME, { force: true });
+    if (item) writeXObjParam(item, srcurl, text_key);
   }
 
-};
+}
 
 /**
- * @classdesc This class implements an instance of a DTS-provider element
+ * @classdesc This class implements an interface of a DTS-provider element
  */
 class TXEpgDTSProvider {
-  /** @property {object} */
+  /** @type {object} */
   #_content;// = null;
-  /** @property {object} */
+  /** @type {OPT_epgelsett_bs} */
   #_options;// = null;
 
   /**
-   * @param {object} obj
-   * @param {object} [opt] - options
-   * @param {object} [opt.parseOptions]
+   * @param {object} obj - host object
+   * @param {OPT_epgelsett_bs} [opt] - options
    * @description Creates an instance of the DTS-provider element
    */
   constructor(obj, opt) {
     // load content
     const _content = isPlainObject(obj) ? obj : {};
     // load options
+    /** @type {OPT_epgelsett_bs} */
     let _options = isPlainObject(opt) ? opt : {};
     let {
       parseOptions,
@@ -609,42 +1183,22 @@ class TXEpgDTSProvider {
 
   /**
    * Contains a dtstype ID
-   * @property {number}
+   * @type {number}
    */
   get dtstype() {
     const item = getXObjElement(this.#_content, XEPG_DTSINFO_ETAG_NAME);
     let result = 0; //-1; // // TODO: [?]
-    if (isPlainObject(item)) {
-      result = valueToIndex(_getXmlChildElementParam(item, 'value'));
-      if (!chkDTSysID(result)) result = 0; //-1; // // TODO: [?]
-    };
+    if (isPlainObject(item)) result = _getDTSTypeValueForXObj(item);
     return result;
   }
 
   set dtstype(value) {
-    let { index, name } = getDTSysDescr(value);
-    if (index !== -1) {
-      const item = insertXObjElement(
-        this.#_content,
-        XEPG_DTSINFO_ETAG_NAME,
-        { force: true },
-      );
-      if (item) {
-        let curItem = insertXObjElement(item, 'value', { force: true });
-        if (
-          curItem
-          && writeXObjParam(curItem, index)
-          && (curItem = insertXObjElement(item, 'name', { force: true }))
-        ) {
-          writeXObjParam(curItem, name);
-        };
-      };
-    };
+    return this.setType(value);
   }
 
   /**
    * Contains a TZ-offset
-   * @property {number}
+   * @type {number}
    */
   get curDocTZ() {
     const tz = convTZStringToValue(
@@ -661,44 +1215,66 @@ class TXEpgDTSProvider {
         XEPG_DOCTZ_ETAG_NAME,
         { force: true },
       );
-      if (item) writeXObjParam(item, _value);
+      if (item) {
+        writeXObjParam(item, _value, defParseOptions.settings.textKey);
+      };
     };
   }
 
-};
+  /**
+   * @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);
+    let isSucceed = false;
+    if (index !== -1) {
+      const item = insertXObjElement(
+        this.#_content,
+        XEPG_DTSINFO_ETAG_NAME,
+        { force: true },
+      );
+      if (item) {
+        let curItem = insertXObjElement(item, 'value', { force: true });
+        if (
+          curItem
+          && writeXObjParam(curItem, index, defParseOptions.settings.textKey)
+          && (curItem = insertXObjElement(item, 'name', { force: true }))
+        ) {
+          isSucceed = writeXObjParam(curItem, name, defParseOptions.settings.textKey);
+        };
+      };
+    };
+    return isSucceed;
+  }
 
-/**
- * @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
- */
+};
 
 /**
- * @classdesc This class implements an instance of a EPG-header element
+ * @classdesc This class implements an interface of a EPG-header element
  */
 class TXEpgHeaderContainer {
-  /** @property {Object} */
+  /** @type {Object} */
   #_host;// = null;
-  /** @property {Object} */
+  /** @type {OPT_epgelsett_bs} */
   #_options;// = null;
-  /** @property {TXmlContentParseOptions} */
+  /** @type {TXmlContentParseOptions} */
   #_parseOptions;// = null;
-  /** @property {TXEpgDTSProvider} */
+  /** @type {TXEpgDTSProvider} */
   #_dtsProv;// = null;
 
   /**
-   * @param {object} obj
-   * @param {object} [opt] - options
-   * @param {object} [opt.parseOptions]
+   * @param {object} obj - host element
+   * @param {OPT_epgelsett_bs} [opt] - options
    * @description Creates an instance of the EPG-header element
    */
   constructor(obj, opt) {
     // load content
     const _host = isPlainObject(obj) ? obj : {};
     // load options
+    /** @type {OPT_epgelsett_bs} */
     const _options = isPlainObject(opt) ? opt : {};
     let {
       parseOptions,
@@ -719,7 +1295,7 @@ class TXEpgHeaderContainer {
 
   /**
    * Returns a `TXEpgDTSProvider` instance
-   * @property {TXEpgDTSProvider}
+   * @type {TXEpgDTSProvider}
    * @readonly
    */
   get dts() {
@@ -728,7 +1304,7 @@ class TXEpgHeaderContainer {
 
   /**
    * Contains a dtstype ID
-   * @property {number}
+   * @type {number}
    * @todo [since v0.0.22] becomes readonly
    */
   get dtstype() {
@@ -741,7 +1317,7 @@ class TXEpgHeaderContainer {
 
   /**
    * Contains a TZ-offset
-   * @property {number}
+   * @type {number}
    * @todo [since v0.0.22] becomes readonly
    */
   get curDocTZ() {
@@ -775,11 +1351,22 @@ class TXEpgHeaderContainer {
   }
 
   /**
-   * @property {?TXEpgProviderContainer}
+   * Returns a `TXEpgProviderContainer` instance
+   * @type {?TXEpgProviderContainer}
    * @readonly
-   * @description Returns a `TXEpgProviderContainer` instance
+   * @deprecated
    */
   get Provider() {
+    return this.provider;
+  }
+
+  /**
+   * Returns a `TXEpgProviderContainer` instance
+   * @since 0.0.22
+   * @type {?TXEpgProviderContainer}
+   * @readonly
+   */
+  get provider() {
     const docProv = this.#_getProv();
     return (
       docProv
@@ -788,6 +1375,16 @@ class TXEpgHeaderContainer {
     );
   }
 
+  /**
+   * Returns a `TXEpgChannelContainer` instance
+   * @since 0.0.22
+   * @type {?TXEpgChannelContainer}
+   * @readonly
+   */
+  get channel() {
+    return new TXEpgChannelContainer(this.#_host, this.#_options);
+  }
+
   /**
    * @returns {number}
    * @description Returns a document creation date as a timestamp
@@ -812,7 +1409,9 @@ class TXEpgHeaderContainer {
       XEPG_DOCDTO_ETAG_NAME,
       { force: true },
     );
-    if (item) writeXObjParam(item, dt_str);
+    if (item) {
+      writeXObjParam(item, dt_str, defParseOptions.settings.textKey);
+    };
   }
 
   /**
@@ -841,7 +1440,9 @@ class TXEpgHeaderContainer {
       XEPG_DOCDTE_ETAG_NAME,
       { force: true },
     );
-    if (item) writeXObjParam(item, dt_str);
+    if (item) {
+      writeXObjParam(item, dt_str, defParseOptions.settings.textKey);
+    };
   }
 
   /**
@@ -849,67 +1450,25 @@ class TXEpgHeaderContainer {
    * @description Returns a channel info
    */
   getChannelInfo() {
-    const _host = this.#_host;
-    /** @type {xepgChnInfoDesc} */
-    let item = {
-      chnid: _getXmlChildElementParam(_host, XEPG_CHNID_ETAG_NAME).trim(),
-      chname: _getXmlChildElementParam(_host, XEPG_CHNNAME_ETAG_NAME).trim(),
-      chngid: _getXmlChildElementParam(_host, XEPG_CHNGID_ETAG_NAME).trim(),
-      srcurl: _getXmlChildElementParam(_host, XEPG_CHNURL_ETAG_NAME).trim(),
-    };
-    return item;
+    return this.channel.getInfo();
   }
 
   /**
    * @param {xepgChnInfoDesc} obj - channel info descriptor
    * @returns {void}
    * @description Sets a channel info
+   * @deprecated
    * @todo [since v0.0.21] deprecate use of `obj`-param as array
+   * @todo [since v0.0.22] deprecated
    */
   setChannelInfo(obj) {
-    let chnid = '';
-    let chname = '';
-    let chngid = '';
-    let srcurl = '';
+    let _obj = obj;
     if (isArray(obj)) {
       // // TODO: [!] deprecate
-      [ chnid, chname, chngid, srcurl ] = obj;
-    } else if (isObject(obj)) {
-      ({ chnid } = obj);
-      if (typeof chnid === 'string') {
-        ({ chname, chngid, srcurl } = obj);
-      } else {
-        // // TODO: [?] deprecate
-        chnid = _getXmlChildElementParam(obj, XEPG_CHNID_ETAG_NAME).trim();
-        chname = _getXmlChildElementParam(obj, XEPG_CHNNAME_ETAG_NAME).trim();
-        chngid = _getXmlChildElementParam(obj, XEPG_CHNGID_ETAG_NAME).trim();
-        srcurl = _getXmlChildElementParam(obj, XEPG_CHNURL_ETAG_NAME).trim();
-      };
-    } else if (typeof obj === 'string') {
-      chnid = obj;
-    } else {
-      return;
-    };
-    chnid = typeof chnid === 'string' ? chnid.trim() : '';
-    if (chnid === '') {
-      chname = '';
-      chngid = '';
-      srcurl = '';
-    } else {
-      chname = typeof chname === 'string' ? chname.trim() : '';
-      chngid = typeof chngid === 'string' ? chngid.trim() : '';
-      srcurl = typeof srcurl === 'string' ? srcurl.trim() : '';
+      const [ chnid, chname, chngid, srcurl ] = _obj;
+      _obj = { chnid, chname, chngid, srcurl };
     };
-    let item = null;
-    const _host = this.#_host;
-    item = insertXObjElement(_host, XEPG_CHNID_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, chnid);
-    item = insertXObjElement(_host, XEPG_CHNNAME_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, chname);
-    item = insertXObjElement(_host, XEPG_CHNGID_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, chngid);
-    item = insertXObjElement(_host, XEPG_CHNURL_ETAG_NAME, { force: true });
-    if (item) writeXObjParam(item, srcurl);
+    return this.channel.setInfo(_obj);
   }
 
   /**
@@ -917,7 +1476,7 @@ class TXEpgHeaderContainer {
    * @description Returns a provider info
    */
   getProviderInfo(){
-    const docProv = this.Provider;
+    const docProv = this.provider;
     return docProv ? docProv.getInfo() : null;
   }
 
@@ -928,18 +1487,18 @@ class TXEpgHeaderContainer {
    */
   setProviderInfo(obj){
     if (isArray(obj) || isObject(obj)) {
-      let docProv = this.Provider;
+      let docProv = this.provider;
       if (!docProv) {
         docProv = this.#_initProv();
-        if (docProv) docProv = this.Provider;
+        if (docProv) docProv = this.provider;
       };
       if (docProv) docProv.setInfo(obj);
     };
   }
 
   /**
-   * @returns {string}
    * @since v0.0.20
+   * @returns {string}
    * @description Returns an instance content as a string in an XML-format.
    */
   saveToXMLString() {
@@ -965,32 +1524,37 @@ class TXEpgHeaderContainer {
  * @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
+ * @property {string} [errMsg] - event message
+ * @property {string} [source] - path to file
+ * @property {any} [content] - file content
  * @description A fs ops description.
  */
 
+/**
+ * @typedef {Object} OPT_epgcpsett
+ * @property {TXmlContentParseOptions} [parseOptions] - parser options
+ * @property {boolean} [autoBindRoot] - <*deprecated*>
+ * @description An options set for `TXEpgContentProvider`-class
+
 /**
  * @classdesc This class implements an interface of the container
  *            that manages a content of a XEPG-document
  */
 class TXEpgContentProvider {
-  /** @property {Object} */
+  /** @type {Object} */
   #_content;// = null;
-  /** @property {Object} */
+  /** @type {OPT_epgcpsett} */
   #_options;// = null;
-  /** @property {?TXmlContentParseOptions} */
+  /** @type {TXmlContentParseOptions} */
   #_parseOptions;// = null;
 
   /**
-   * @param {object} [opt] - options
-   * @param {object} [opt.parseOptions]
-   * @param {boolean} [opt.autoBindRoot] - <*reserved*> ([?] - deprecate)
+   * @param {OPT_epgcpsett} [opt] - options
    * @description Creates an instance of the XEPG-content provider
    */
   constructor(opt) {
     // load options
+    /** @type {OPT_epgcpsett} */
     const _options = isPlainObject(opt) ? opt : {};
     let {
       parseOptions,
@@ -1030,7 +1594,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;
@@ -1096,8 +1665,9 @@ class TXEpgContentProvider {
 
   /**
    * Returns a `TXEpgHeaderContainer` instance
-   * @property {?TXEpgHeaderContainer}
+   * @type {?TXEpgHeaderContainer}
    * @readonly
+   * @deprecated
    */
   get Header() {
     const docHdr = this.#_getHdr();
@@ -1108,23 +1678,50 @@ class TXEpgContentProvider {
     );
   }
 
+  /**
+   * Returns a `TXEpgHeaderContainer` instance
+   * @since 0.0.22
+   * @type {?TXEpgHeaderContainer}
+   * @readonly
+   */
+  get header() {
+    const docHdr = this.#_getHdr();
+    return (
+      docHdr
+      ? new TXEpgHeaderContainer(docHdr, this.#_options)
+      : null
+    );
+  }
+
   /**
    * Returns a `TXEpgProviderContainer` instance
-   * @property {?TXEpgProviderContainer}
+   * @type {?TXEpgProviderContainer}
    * @readonly
+   * @deprecated
    */
   get Provider() {
-    const docHdr = this.Header;
-    return docHdr ? docHdr.Provider : null;
+    const docHdr = this.header;
+    return docHdr ? docHdr.provider : null;
+  }
+
+  /**
+   * Returns a `TXEpgProviderContainer` instance
+   * @since 0.0.22
+   * @type {?TXEpgProviderContainer}
+   * @readonly
+   */
+  get provider() {
+    const docHdr = this.header;
+    return docHdr ? docHdr.provider : null;
   }
 
   /**
    * Returns a `TXEpgDTSProvider` instance
-   * @property {?TXEpgDTSProvider}
+   * @type {?TXEpgDTSProvider}
    * @readonly
    */
   get dts() {
-    const docHdr = this.Header;
+    const docHdr = this.header;
     return docHdr ? docHdr.dts : null;
   }
 
@@ -1136,7 +1733,7 @@ class TXEpgContentProvider {
 
   /**
    * Returns a `TXEpgSchedulesList` instance
-   * @property {TXEpgSchedulesList}
+   * @type {TXEpgSchedulesList}
    * @readonly
    */
   get SchedulesList() {
@@ -1181,7 +1778,7 @@ class TXEpgContentProvider {
         docHdr,
         XEPG_PRVINFO_ETAG_NAME,
       );
-      if (docProv) this.Provider.init();
+      if (docProv) this.provider.init();
       // initiate document body element
       let docBody = this.#_getBody();
       if (!docBody) docBody = this.#_initBody();
@@ -1279,10 +1876,10 @@ class TXEpgContentProvider {
   }
 
   /**
+   * @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) {
@@ -1332,7 +1929,7 @@ class TXEpgContentProvider {
   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)) {
@@ -1363,7 +1960,7 @@ class TXEpgContentProvider {
    * @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)) {
@@ -1393,16 +1990,22 @@ class TXEpgContentProvider {
 
 // === module exports block ===
 
-exports.TXEpgDTSProvider = TXEpgDTSProvider;
-exports.TXEpgSchedulesList = TXEpgSchedulesList;
-exports.TXEpgProviderContainer = TXEpgProviderContainer;
-exports.TXEpgHeaderContainer = TXEpgHeaderContainer;
-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;
+
+module.exports.readAsTagName = readAsTagName;
+module.exports.readAsAttrName = readAsAttrName;
+module.exports.valueToElementID = valueToElementID;
 
-exports.XEPG_DEF_PROVIDER_NAME = XEPG_DEF_PROVIDER_NAME;
-exports.XEPG_DEF_PROVIDER_VER = XEPG_DEF_PROVIDER_VER;
-exports.XEPG_DEF_DOCUMENT_TYPE = XEPG_DEF_DOCUMENT_TYPE;
-exports.XEPG_DEF_DOCUMENT_SCHEMA = XEPG_DEF_DOCUMENT_SCHEMA;
+module.exports.TXEpgDTSProvider = TXEpgDTSProvider;
+module.exports.TXEpgScheduleItem = TXEpgScheduleItem;
+module.exports.TXEpgSchedulesList = TXEpgSchedulesList;
+module.exports.TXEpgProviderContainer = TXEpgProviderContainer;
+module.exports.TXEpgChannelContainer = TXEpgChannelContainer;
+module.exports.TXEpgHeaderContainer = TXEpgHeaderContainer;
+module.exports.TXEpgContentProvider = TXEpgContentProvider;
 
 /** @deprecated */
-exports.TXepgDTSProvider = TXEpgDTSProvider;
+module.exports.TXepgDTSProvider = TXEpgDTSProvider;