@ygracs/xepg-lib-js 0.0.26-b → 0.0.30

package/lib/xepgdoc-lib.js

@@ -1,24 +1,23 @@
-// [v0.2.132-20260122]
+// [v0.3.153-20260612]
 
 // === module init block ===
 
 const xmlParser = require('@ygracs/xml-js6');
 
 const {
-  valueToIndex, valueToIDString,
-  readAsString, readAsNumber,
+  readAsString,
   isNotEmptyString,
   isArray, isObject, isPlainObject,
 } = require('@ygracs/bsfoc-lib-js');
 
 const {
   convValueToTZString, convTZStringToValue,
-  tryDTValue,
 } = require('@ygracs/dtf-lib-js');
 
 const {
-  chkDTSysID, getDTSysDescr,
+  getDTSysDescr,
   convStringToDTValue, convDTValueToString,
+  _getDTSTypeValueForXObj,
 } = require('./dts-helper.js');
 
 const {
@@ -34,142 +33,64 @@ const {
   getXObjElement,
   insertXObjElement,
   writeXObjParam,
-  writeXObjAttr,
+  readXObjAttr, writeXObjAttr,
   //TXmlContentParseOptions,
+  DEF_XML_PARSE_OPTIONS: XML_DEF_PARSE_OPTIONS,
 } = xObj;
 // keep the next line for a type checking work properly :(
 const { TXmlContentParseOptions } = require('@ygracs/xobj-lib-js/lib/xObj-defs');
+// keep the next line for a type checking work properly :(
+const { INode } = require('@ygracs/xobj-lib-js/lib/xObj-lib');
 
 const {
-  readAsTagName,
-  readAsAttrName,
-  valueToElementID,
+  //readAsTagName,
+  //readAsAttrName,
+  //valueToElementID,
+  serializeXObjToXMLString, deserializeXObjFromXMLString,
+  _getXmlChildElementParam,
 } = require('./xml-base');
 
-// === module inner block ===
-
-/*
- * === xObj-function wrappers (start) ===
- */
-
-function readXObjParam(obj){
-  return xObj.readXObjParam(obj, defParseOptions.settings.textKey);
-};
-
-/*
- * === xObj-function wrappers (end) ===
- */
-
-/***
- * (* helper function definitions *)
- */
+const {
+  XEPG_CONSTANTS, XEPG_DEF_TNAMES,
+  defParseOptionsSettings,
+} = require('./xepg-defs');
 
-/**
- * @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) : '';
-};
+const {
+  TXEpgSchedulesList,
+} = require('./xepg-sched');
 
-/**
- * @param {object} obj - element
- * @returns {number}
- * @inner
- */
-function _getDTSTypeValueForXObj(obj) {
-  const result = valueToIndex(
-    _getXmlChildElementParam(obj, 'value')
-  );
-  return chkDTSysID(result) ? result : 0; //-1; // // TODO: [?]
-};
+const {
+  TXEpgChannelContainer,
+  // * import types definitions *
+  IXEpgChnInfoDesc,
+} = require('./xepg-channel');
 
-/**
- * @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;
-  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] = {};
-    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);
-  };
-};
+// === module inner block ===
 
-/**
- * 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;
-};
+const {
+  XEPG_DEF_NS_NAME,
+  XEPG_DEF_NS_PATH,
+  XEPG_XML_DOC_VERSION,
+  XEPG_DEF_ENCODING_VALUE,
+  XEPG_DEF_DOCUMENT_TYPE,
+  XEPG_DEF_DOCUMENT_SCHEMA,
+  XEPG_DEF_PROVIDER_NAME,
+  XEPG_DEF_PROVIDER_VER,
+} = XEPG_CONSTANTS;
 
-/**
- * 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;
-};
+const {
+  XEPG_ROOT_ETAG_NAME,
+  XEPG_HEADER_ETAG_NAME,
+  XEPG_BODY_ETAG_NAME,
+  XEPG_SCHED_ETAG_NAME,
+  XEPG_PRVINFO_ETAG_NAME,
+  XEPG_DTSINFO_ETAG_NAME,
+  XEPG_DOCDTO_ETAG_NAME,
+  XEPG_DOCDTE_ETAG_NAME,
+  XEPG_DOCTZ_ETAG_NAME,
+  XEPG_DOCSCH_ETAG_NAME,
+  XEPG_DOCTYP_ETAG_NAME,
+} = XEPG_DEF_TNAMES;
 
 /**
  * An XEPG-element options set (base)
@@ -206,43 +127,8 @@ function __evalXMLBaseNodeSettings(value) {
 
 // === module main block ===
 
-/***
- * (* 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';
-const XEPG_HEADER_ETAG_NAME = `${XEPG_DEF_NS_NAME}:info`;
-const XEPG_BODY_ETAG_NAME = `${XEPG_DEF_NS_NAME}:list`;
-const XEPG_SCHED_ETAG_NAME = `${XEPG_DEF_NS_NAME}:item`;
-const XEPG_PRVINFO_ETAG_NAME = `${XEPG_DEF_NS_NAME}:provider`;
-const XEPG_DTSINFO_ETAG_NAME = `${XEPG_DEF_NS_NAME}:dtstype`;
-const XEPG_DOCDTO_ETAG_NAME = `${XEPG_DEF_NS_NAME}:time`;
-const XEPG_DOCDTE_ETAG_NAME = `${XEPG_DEF_NS_NAME}:expire`;
-const XEPG_DOCTZ_ETAG_NAME = `${XEPG_DEF_NS_NAME}:timezone`;
-const XEPG_DOCSCH_ETAG_NAME = `${XEPG_DEF_NS_NAME}:schema`;
-const XEPG_DOCTYP_ETAG_NAME = `${XEPG_DEF_NS_NAME}:doctype`;
-const XEPG_CHNID_ETAG_NAME = `${XEPG_DEF_NS_NAME}:chnid`;
-const XEPG_CHNNAME_ETAG_NAME = `${XEPG_DEF_NS_NAME}:chname`;
-const XEPG_CHNGID_ETAG_NAME = `${XEPG_DEF_NS_NAME}:chngid`;
-const XEPG_CHNURL_ETAG_NAME = `${XEPG_DEF_NS_NAME}:srcurl`;
-const XEPG_SCHEDTIME_ETAG_NAME = `${XEPG_DEF_NS_NAME}:time`;
-const XEPG_SCHEDTITL_ETAG_NAME = `${XEPG_DEF_NS_NAME}:title`;
-const XEPG_SCHEDCAT_ETAG_NAME = `${XEPG_DEF_NS_NAME}:cat`;
-const XEPG_SCHEDPMARK_ETAG_NAME = `${XEPG_DEF_NS_NAME}:pcmark`;
-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 = ALLOWED_XEPG_DOCUMENT_SCHEMA[0];
-const XEPG_DEF_PROVIDER_NAME = 'xepg-lib-js';
-const XEPG_DEF_PROVIDER_VER = '0.0.21';
+const XML_TE_INVARG_EMSG = 'invalid argument';
+const XML_TE_NOBJ_EMSG = `${XML_TE_INVARG_EMSG} (an object is expected)`;
 
 const defXEpgDocOptions = {
   xmlns_xepg_pref: XEPG_DEF_NS_NAME,
@@ -262,537 +148,37 @@ const defXEpgDocOptions = {
   },
 };
 
-const defParseOptions = new TXmlContentParseOptions();
-//console.log('CHECK: defParseOptions => '+JSON.stringify(defParseOptions, null, 2));
-
-/***
- * (* function definitions *)
- */
-
-/***
- * (* 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
- */
-
-/**
- * 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 {
-  /** @type {object} */
-  #_host;
-  /** @type {OPT_epgelsett_ex} */
-  #_options;
-  /** @type {TXmlContentParseOptions} */
-  #_parseOptions;
-  /** @type {?object} */
-  #_dts_src = null;
-  /** @type {?object} */
-  #_tz_src = null;
-
-  /**
-   * Creates an instance of the EPG-schedule element
-   * @param {object} obj - host object
-   * @param {OPT_epgelsett_ex} [opt] - options
-   * @param {OPT_extra} [extra] - \[since `v0.0.24`] extra options
-   */
-  constructor(obj, opt, extra) {
-    // load content
-    const _host = isPlainObject(obj) ? obj : {};
-    // load options
-    /** @type {OPT_epgelsett_ex} */
-    const _options = isPlainObject(opt) ? opt : {};
-    let {
-      parseOptions,
-    } = _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
-    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 a schedule info item descriptor
-   * @returns {xepgShedInfoDesc}
-   */
-  getInfo() {
-    const {
-      time,
-      title,
-      category: cat,
-      rating: pcmark,
-      descr,
-    } = this;
-    return {
-      time,
-      title,
-      cat,
-      pcmark,
-      descr,
-    };
-  }
-
-  /**
-   * Sets a schedule start time.
-   * @param {(number|string|Date)} value - some time value
-   * @returns {boolean}
-   */
-  setTime(value) {
-    let { isSucceed, value: dtValue } = tryDTValue(value);
-    let result = false;
-    if (isSucceed && dtValue != null) {
-      const text = convDTValueToString(dtValue, this.dtstype, this.curDocTZ);
-      if (text !== '') {
-        const opt = { force: true };
-        const item = insertXObjElement(this.#_host, XEPG_SCHEDTIME_ETAG_NAME, opt);
-        if (item) {
-          result = writeXObjParam(item, text, defParseOptions.settings.textKey);
-        };
-      };
-    };
-    return result;
-  }
-
-  /**
-   * Sets a schedule title.
-   * @param {string} value - some title
-   * @returns {boolean}
-   */
-  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;
-  }
-
-  /**
-   * Sets a schedule title.
-   * @param {string} value - some title
-   * @returns {boolean}
-   */
-  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;
-  }
-
-  /**
-   * Sets a schedule rating value.
-   * @param {(number|string)} value - some value
-   * @returns {boolean}
-   */
-  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;
-  }
-
-  /**
-   * Sets a schedule description.
-   * @param {string} value - some text
-   * @returns {boolean}
-   */
-  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 an instance content as a string in an XML-format.
-   * @returns {string}
-   */
-  saveToXMLString() {
-    const options = this.#_parseOptions.js2xml;
-    options.ignoreDocType = true;
-    options.ignoreDeclaration = true;
-    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,
-    );
-  }
-
-};
-
 /**
- * @classdesc This class implements an interface of a EPG-schedules list
+ * A list of fields in order: `name`, `version`, `schema`, `doctype`
+ * @typedef {string[]} arrProviderInfo
+ * @deprecated
+ * @todo \[since v0.0.21] deprecated and will be removed
  */
-class TXEpgSchedulesList {
-  /** @type {object[]} */
-  #_content;
-  /** @type {OPT_epgelsett_ex} */
-  #_options;
-  /** @type {?object} */
-  #_dts_src = null;
-  /** @type {?object} */
-  #_tz_src = null;
-
-  /**
-   * Creates an instance of the schedules list
-   * @param {any[]} obj - list of an elements
-   * @param {OPT_epgelsett_ex} [opt] - options
-   * @param {OPT_extra} [extra] - \[since `v0.0.24`] extra options
-   */
-  constructor(obj, opt, extra) {
-    const _content = isArray(obj) ? obj : [];
-    /** @type {OPT_epgelsett_ex} */
-    const _options = isPlainObject(opt) ? opt : {};
-    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
-    this.#_content = _content;
-    // save options
-    this.#_options = _options;
-    // save refs to a time source priveders
-    this.#_dts_src = dts_src;
-    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}
-   */
-  #_getItem = function(value) {
-    if (this.chkIndex(value)) {
-      return this.#_content[Number(value)];
-    };
-  };
-
-  /**
-   * Contains a quantity of a schedules
-   * @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
-   * @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
-    );
-  }
-
-  /**
-   * Indicates whether an instance has none member
-   * @returns {boolean}
-   * @deprecated
-   * @todo \[since `v0.0.24`] deprecated. Use `TXEpgSchedulesList.isEmpty`
-   */
-  hasNoSchedules() {
-    return this.count === 0;
-  }
-
-  /**
-   * Indicates whether an instance has none member
-   * @since v0.0.24
-   * @returns {boolean}
-   */
-  isEmpty() {
-    return this.count === 0;
-  }
-
-  /**
-   * Indicates whether an instance has any member
-   * @returns {boolean}
-   * @deprecated
-   * @todo \[since `v0.0.24`] deprecated. Use `TXEpgSchedulesList.isNotEmpty`
-   */
-  hasSchedules() {
-    return this.count > 0;
-  }
-
-  /**
-   * 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
-   * @param {(number|string)} value - index of some element
-   * @returns {boolean}
-   */
-  chkIndex(value) {
-    const index = valueToIndex(value);
-    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}
-   */
-  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;
-  }
-
-  /**
-   * Returns a schedule info item for instance element addressed
-   * by a given index
-   * @param {(number|string)} index - index of some element
-   * @returns {?xepgShedInfoDesc}
-   */
-  getScheduleInfo(index) {
-    const obj = this.schedule(index);
-    return obj ? obj.getInfo() : null;
-  }
-
-  /**
-   * Returns a schedule info for instance members
-   * @returns {xepgShedInfoDesc[]}
-   */
-  getAllSchedulesInfo() {
-    let result = [];
-    for (let i = 0; i < this.count; i++) {
-      let item = this.getScheduleInfo(i);
-      if (isPlainObject(item)) result.push(item);
-    };
-    return result;
-  }
-
-  /**
-   * @protected
-   */
-  asJSON() {
-    return JSON.stringify(this.#_content, null, 2);
-  }
-
-};
+/**
+ * A virtual constant meant for support jsdoc notation:
+ * @type {arrProviderInfo}
+ */
+module.exports.arrProviderInfo = [];
 
 /**
  * A provider info descriptor
- * @typedef {Object} xepgProvInfoDesc
+ * @typedef {Object} IXEpgProvInfoDesc
  * @property {string} [name] - provider name
  * @property {string} [version] - provider version
  * @property {string} schema - document schema
  * @property {string} doctype - document type
  */
+/**
+ * A virtual constant meant for support jsdoc notation:
+ * @type {IXEpgProvInfoDesc}
+ */
+module.exports.IXEpgProvInfoDesc = { schema: '', doctype: '' };
 
 /**
  * @classdesc This class implements an interface of a EPG-provider element
  */
 class TXEpgProviderContainer {
-  /** @type {Object} */
+  /** @type {INode} */
   #_host;
   /** @type {OPT_epgelsett_bs} */
   #_options;
@@ -801,7 +187,7 @@ class TXEpgProviderContainer {
 
   /**
    * Creates an instance of the EPG-provider element
-   * @param {object} obj - host object
+   * @param {INode} obj - host object
    * @param {OPT_epgelsett_bs} [opt] - options
    */
   constructor(obj, opt) {
@@ -859,7 +245,7 @@ class TXEpgProviderContainer {
       const opt = { force: true };
       const item = insertXObjElement(this.#_host, 'version', opt);
       if (item) {
-        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+        writeXObjParam(item, value.trim(), defParseOptionsSettings.textKey);
       };
     };
   }
@@ -877,7 +263,7 @@ class TXEpgProviderContainer {
       const opt = { force: true };
       const item = insertXObjElement(this.#_host, XEPG_DOCSCH_ETAG_NAME, opt);
       if (item) {
-        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+        writeXObjParam(item, value.trim(), defParseOptionsSettings.textKey);
       };
     };
   }
@@ -895,7 +281,7 @@ class TXEpgProviderContainer {
       const opt = { force: true };
       const item = insertXObjElement(this.#_host, XEPG_DOCTYP_ETAG_NAME, opt);
       if (item) {
-        writeXObjParam(item, value.trim(), defParseOptions.settings.textKey);
+        writeXObjParam(item, value.trim(), defParseOptionsSettings.textKey);
       };
     };
   }
@@ -911,7 +297,7 @@ class TXEpgProviderContainer {
       const name = value.trim();
       const item = insertXObjElement(this.#_host, 'name', { force: true });
       if (item) {
-        isSucceed = writeXObjParam(item, name, defParseOptions.settings.textKey);
+        isSucceed = writeXObjParam(item, name, defParseOptionsSettings.textKey);
       };
     };
     return isSucceed;
@@ -919,7 +305,7 @@ class TXEpgProviderContainer {
 
   /**
    * Returns a provider info item
-   * @returns {xepgProvInfoDesc}
+   * @returns {IXEpgProvInfoDesc}
    */
   getInfo() {
     return {
@@ -932,7 +318,7 @@ class TXEpgProviderContainer {
 
   /**
    * Sets a provider info
-   * @param {(string[]|xepgProvInfoDesc)} obj - provider info descriptor
+   * @param {arrProviderInfo|IXEpgProvInfoDesc} obj - provider info descriptor
    * @returns {void}
    * @todo [since v0.0.21] deprecate use of `obj`-param as array
    */
@@ -969,20 +355,20 @@ class TXEpgProviderContainer {
 
   /**
    * Sets an initial instance state
-   * @param {(xepgProvInfoDesc|string[])} [opt] - options
+   * @param {arrProviderInfo|IXEpgProvInfoDesc} [data] - options
    * @returns {void}
+   * @todo [since v0.0.30] deprecate use of `obj`-param as array
    */
-  init(opt) {
+  init(data) {
     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;
+    if (isArray(data)) {
+      [ name, version, schema, doctype ] = data;
     } else {
-      ({ name, version, schema, doctype } = _options);
+      ({ name, version, schema, doctype } = isObject(data) ? data : {});
     };
     name = readAsString(name, { defValue: prov_opt.name, useTrim: true });
     version = readAsString(version, { defValue: prov_opt.version, useTrim: true });
@@ -1031,229 +417,20 @@ class TXEpgProviderContainer {
   }
 
 };
-
-/**
- * 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
- */
-
-/**
- * @since 0.0.22
- * @classdesc This class implements an interface of a channel element
- */
-class TXEpgChannelContainer {
-  /** @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 {OPT_epgelsett_bs} [opt] - options
-   */
-  constructor(obj, opt) {
-    // load content
-    const _host = isPlainObject(obj) ? obj : {};
-    // load options
-    const _options = __evalXMLBaseNodeSettings(opt);
-    let {
-      parseOptions,
-    } = _options;
-    // 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);
-      };
-    };
-  }
-
-  /**
-   * Tries to set a channel ID
-   * @param {string} value - channel ID
-   * @returns {boolean}
-   */
-  setID(value) {
-    let isSucceed = false;
-    if (typeof value === 'string') {
-      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 a channel info
-   * @returns {xepgChnInfoDesc}
-   */
-  getInfo() {
-    const {
-      id: chnid,
-      name: chname,
-      gid: chngid,
-      url: srcurl,
-    } = this;
-    /** @type {xepgChnInfoDesc} */
-    return {
-      chnid,
-      chname,
-      chngid,
-      srcurl,
-    };
-  }
-
-  /**
-   * Sets a channel info
-   * @param {(string|xepgChnInfoDesc)} obj - channel info descriptor
-   * @returns {void}
-   */
-  setInfo(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
-        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() : '';
-    };
-    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);
-  }
-
-}
+module.exports.TXEpgProviderContainer = TXEpgProviderContainer;
 
 /**
  * @classdesc This class implements an interface of a DTS-provider element
  */
 class TXEpgDTSProvider {
-  /** @type {object} */
+  /** @type {INode} */
   #_content;
   /** @type {OPT_epgelsett_bs} */
   #_options;
 
   /**
    * Creates an instance of the DTS-provider element
-   * @param {object} obj - host object
+   * @param {INode} obj - host object
    * @param {OPT_epgelsett_bs} [opt] - options
    */
   constructor(obj, opt) {
@@ -1314,7 +491,7 @@ class TXEpgDTSProvider {
         { force: true },
       );
       if (item) {
-        writeXObjParam(item, _value, defParseOptions.settings.textKey);
+        writeXObjParam(item, _value, defParseOptionsSettings.textKey);
       };
     };
   }
@@ -1322,7 +499,7 @@ class TXEpgDTSProvider {
   /**
    * Tries to set a `DTS`-type
    * @since 0.0.22
-   * @property {(number|string)} value - dtstype ID
+   * @param {number|string} value - dtstype ID
    * @returns {boolean}
    */
   setType(value) {
@@ -1338,10 +515,10 @@ class TXEpgDTSProvider {
         let curItem = insertXObjElement(item, 'value', { force: true });
         if (
           curItem
-          && writeXObjParam(curItem, index, defParseOptions.settings.textKey)
+          && writeXObjParam(curItem, index, defParseOptionsSettings.textKey)
           && (curItem = insertXObjElement(item, 'name', { force: true }))
         ) {
-          isSucceed = writeXObjParam(curItem, name, defParseOptions.settings.textKey);
+          isSucceed = writeXObjParam(curItem, name, defParseOptionsSettings.textKey);
         };
       };
     };
@@ -1354,7 +531,7 @@ class TXEpgDTSProvider {
  * @classdesc This class implements an interface of a EPG-header element
  */
 class TXEpgHeaderContainer {
-  /** @type {Object} */
+  /** @type {INode} */
   #_host;
   /** @type {OPT_epgelsett_bs} */
   #_options;
@@ -1365,7 +542,7 @@ class TXEpgHeaderContainer {
 
   /**
    * Creates an instance of the EPG-header element
-   * @param {object} obj - host element
+   * @param {INode} obj - host element
    * @param {OPT_epgelsett_bs} [opt] - options
    */
   constructor(obj, opt) {
@@ -1382,6 +559,8 @@ class TXEpgHeaderContainer {
     this.#_parseOptions = parseOptions;
     // save content source
     this.#_host = _host;
+    // init required elements
+    this.#_initProv();
     // init DTS-provider
     this.#_dtsProv = new TXEpgDTSProvider(_host, _options);
   }
@@ -1459,7 +638,7 @@ class TXEpgHeaderContainer {
   /**
    * Returns a `TXEpgChannelContainer` instance
    * @since 0.0.22
-   * @type {?TXEpgChannelContainer}
+   * @type {TXEpgChannelContainer}
    * @readonly
    */
   get channel() {
@@ -1491,7 +670,7 @@ class TXEpgHeaderContainer {
       { force: true },
     );
     if (item) {
-      writeXObjParam(item, dt_str, defParseOptions.settings.textKey);
+      writeXObjParam(item, dt_str, defParseOptionsSettings.textKey);
     };
   }
 
@@ -1522,63 +701,27 @@ class TXEpgHeaderContainer {
       { force: true },
     );
     if (item) {
-      writeXObjParam(item, dt_str, defParseOptions.settings.textKey);
+      writeXObjParam(item, dt_str, defParseOptionsSettings.textKey);
     };
   }
 
   /**
    * Returns a channel info
-   * @returns {xepgChnInfoDesc}
+   * @returns {IXEpgChnInfoDesc}
    */
   getChannelInfo() {
     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. Use `TXEpgChannelContainer.setInfo`
-   */
-  setChannelInfo(obj) {
-    let _obj = obj;
-    if (isArray(obj)) {
-      // // TODO: [!] deprecate
-      const [ chnid, chname, chngid, srcurl ] = _obj;
-      _obj = { chnid, chname, chngid, srcurl };
-    };
-    return this.channel.setInfo(_obj);
-  }
-
   /**
    * Returns a provider info
-   * @returns {?xepgProvInfoDesc}
+   * @returns {?IXEpgProvInfoDesc}
    */
   getProviderInfo() {
     const docProv = this.provider;
     return docProv ? docProv.getInfo() : null;
   }
 
-  /**
-   * Sets a provider info
-   * @param {xepgProvInfoDesc} obj - provider info descriptor
-   * @returns {void}
-   * @deprecated
-   * @todo \[since `v0.0.24`] deprecated. Use `TXEpgProviderContainer.setInfo`
-   */
-  setProviderInfo(obj) {
-    if (isArray(obj) || isObject(obj)) {
-      let docProv = this.provider;
-      if (!docProv) {
-        docProv = this.#_initProv();
-        if (docProv) docProv = this.provider;
-      };
-      if (docProv) docProv.setInfo(obj);
-    };
-  }
-
   /**
    * Returns an instance content as a string in an XML-format.
    * @since v0.0.20
@@ -1616,6 +759,112 @@ class TXEpgHeaderContainer {
   }
 
 };
+module.exports.TXEpgHeaderContainer = TXEpgHeaderContainer;
+
+/**
+ * @since v0.0.30
+ * @classdesc This class implements an instance of an element
+ *            that managea content of a document declaration
+ */
+class TXmlContentDeclaration {
+  /** @type {INode} */
+  #_host;
+  /** @type {XEpgElementConfigBase} */
+  #_config;
+  /** @type {object} */
+  #_ctrls;
+
+  /**
+   * Creates an instance of the element
+   * @param {INode} obj - some object
+   * @param {OPT_epgelsett_bs} [opt] - options
+   * @throws {TypeError}
+   */
+  constructor(obj, opt) {
+    if (!isPlainObject(obj)) {
+      throw new TypeError(`TXmlContentDeclaration : ${XML_TE_NOBJ_EMSG}`);
+    };
+    // load options
+    //const _options = __evalXMLContainerSettings(opt);
+    const config = __evalXMLBaseNodeSettings(opt);
+    // set parser options
+    let { settings } = config.parseOptions;
+    let { declarationKey } = settings;
+    // // TODO: [!] need to be rewritten
+    // // ([!] need support from `TXmlContentParseOptions` for correct ops)
+    if (
+      typeof declarationKey !== 'string'
+      || ((declarationKey = declarationKey.trim()) === '')
+    ) {
+      declarationKey = XML_DEF_PARSE_OPTIONS.declarationKey;
+      settings.declarationKey = declarationKey;
+    };
+    // save options
+    this.#_config = config;
+    // bind a documents content
+    this.#_host = obj;
+    // init a content declaration element
+    this.init();
+  }
+
+  /**
+   * Contains a version of an XML
+   * @type {string}
+   */
+  get version() {
+    return readXObjAttr(
+      this.#_ctrls,
+      'version',
+      this.#_config.parseOptions.settings.attributesKey,
+    );
+  }
+
+  set version(value) {
+    writeXObjAttr(
+      this.#_ctrls,
+      'version',
+      value,
+      this.#_config.parseOptions.settings.attributesKey,
+    );
+  }
+
+  /**
+   * Contains a document character set
+   * @type {string}
+   */
+  get encoding() {
+    return readXObjAttr(
+      this.#_ctrls,
+      'encoding',
+      this.#_config.parseOptions.settings.attributesKey,
+    );
+  }
+
+  set encoding(value) {
+    writeXObjAttr(
+      this.#_ctrls,
+      'encoding',
+      value,
+      this.#_config.parseOptions.settings.attributesKey,
+    );
+  }
+
+  /**
+   * Initializes an instance content.
+   * @returns {void}
+   */
+  init() {
+    this.#_ctrls = insertXObjElement(
+      this.#_host,
+      this.#_config.parseOptions.settings.declarationKey,
+    );
+    // set version & encoding
+    if (!isNotEmptyString(this.version)) this.version = XEPG_XML_DOC_VERSION;
+    if (!isNotEmptyString(this.encoding)) this.encoding = XEPG_DEF_ENCODING_VALUE;
+  }
+
+};
+module.exports.TXmlContentDeclaration = TXmlContentDeclaration;
 
 /**
  * An options set for `TXEpgContentProvider`-class
@@ -1626,7 +875,7 @@ class TXEpgHeaderContainer {
 
 /**
  * An options set for `TXEpgContentProvider`-class
- * @typedef {Object} XEpgContainerSettings
+ * @typedef {Object} XEpgContainerConfig
  * @property {TXmlContentParseOptions} parseOptions - parser options
  * @property {boolean} [autoBindRoot] - <*deprecated*>
  */
@@ -1636,12 +885,18 @@ class TXEpgHeaderContainer {
  *            that manages a content of a XEPG-document
  */
 class TXEpgContentProvider {
-  /** @type {Object} */
+  /** @type {INode} */
   #_content;
-  /** @type {XEpgContainerSettings} */
+  /** @type {XEpgContainerConfig} */
   #_options;
   /** @type {TXmlContentParseOptions} */
   #_parseOptions;
+  /** @type {TXmlContentDeclaration} */
+  #_docDecl;
+  /** @type {TXEpgHeaderContainer} */
+  #_hdrSect;
+  /** @type {TXEpgSchedulesList} */
+  #_schedSect;
 
   /**
    * Creates an instance of the XEPG-content provider
@@ -1649,45 +904,47 @@ class TXEpgContentProvider {
    */
   constructor(opt) {
     // load options
-    const _options = __evalXMLBaseNodeSettings(opt);
-    /** @type {XEpgContainerSettings} */
+    /** @type {XEpgContainerConfig} */
+    const config = __evalXMLBaseNodeSettings(opt);
     let {
       parseOptions,
       autoBindRoot, // <*reserved*> ([?] - deprecate)
-    } = _options;
+    } = config;
     if (typeof autoBindRoot !== 'boolean') autoBindRoot = false;
     // save options
     //_options.autoBindRoot = autoBindRoot; //* // TODO:
-    this.#_options = _options;
+    this.#_options = config;
     // save parser options
     this.#_parseOptions = parseOptions;
     // init document content
-    this.#_content = {};
+    const content = this.#_content = {};
+    // init a content declaration element
+    this.#_docDecl = new TXmlContentDeclaration(content, config);
     this.init();
   }
 
   /**
-   * @returns {?Object}
-   */
-  #_getRoot() {
-    const docRoot = getXObjElement(this.#_content, XEPG_ROOT_ETAG_NAME);
-    return isPlainObject(docRoot) ? docRoot : null;
-  }
-
-  /**
+   * Initializes a content root element
+   * @param {object} [obj] - object to initialize
+   * @param {TXmlContentParseOptions} [opt] - parser options
    * @returns {?object}
    */
-  #_initRoot() {
-    const _content = this.#_content;
-    let docRoot = getXObjElement(_content, XEPG_ROOT_ETAG_NAME);
+  #_initRoot(obj, opt) {
+    const content = obj ?? this.#_content;
+    let docRoot = getXObjElement(content, XEPG_ROOT_ETAG_NAME);
     if (!docRoot) {
-      docRoot = insertXObjElement(_content, XEPG_ROOT_ETAG_NAME);
+      docRoot = insertXObjElement(content, XEPG_ROOT_ETAG_NAME);
       if (docRoot) {
+        const config = (
+          opt && opt.settings
+          ? opt.settings
+          : defParseOptionsSettings
+        );
         writeXObjAttr(
           docRoot,
           `xmlns:${XEPG_DEF_NS_NAME}`,
           XEPG_DEF_NS_PATH,
-          defParseOptions.settings.attributesKey,
+          config.attributesKey,
         );
       };
     };
@@ -1695,72 +952,72 @@ class TXEpgContentProvider {
   }
 
   /**
-   * @returns {?Object}
+   * Initializes a document content.
+   * @since 0.0.30
+   * @param {object} content - some object to initialize
+   * @param {XEpgContainerConfig} opt - options
+   * @param {boolean} mode - flag
+   * @returns {fsoDescr}
    */
-  #_getHdr() {
-    const docRoot = this.#_getRoot();
-    let docHdr = null;
-    if (docRoot) {
-      docHdr = getXObjElement(docRoot, XEPG_HEADER_ETAG_NAME);
+  #_initContent(content, opt, mode) {
+    /** @type {fsoDescr} */
+    const result = {
+      isERR: false,
+      errCode: undefined,
+      errEvent: '',
+      errMsg: '',
     };
-    return isPlainObject(docHdr) ? docHdr : null;
-  }
-
-  /**
-   * @returns {?object}
-   */
-  #_initHdr() {
-    let docHdr = this.#_getHdr();
-    if (!docHdr) {
-      let docRoot = this.#_getRoot();
-      if (!docRoot) docRoot = this.#_initRoot();
-      if (docRoot) {
+    // initiate document root element
+    let docRoot = getXObjElement(content, XEPG_ROOT_ETAG_NAME);
+    if (!docRoot) docRoot = this.#_initRoot(content, opt.parseOptions);
+    if (docRoot) {
+      // init a document header element
+      let docHdr = getXObjElement(docRoot, XEPG_HEADER_ETAG_NAME);
+      if (!docHdr) {
         docHdr = insertXObjElement(docRoot, XEPG_HEADER_ETAG_NAME);
       };
-    };
-    return isPlainObject(docHdr) ? docHdr : null;
-  }
-
-  /**
-   * @returns {?Object}
-   */
-  #_getBody() {
-    const docRoot = this.#_getRoot();
-    let docBody = null;
-    if (docRoot) {
-      docBody = getXObjElement(docRoot, XEPG_BODY_ETAG_NAME);
-    };
-    return isPlainObject(docBody) ? docBody : null;
-  }
-
-  /**
-   * @returns {?object}
-   */
-  #_initBody() {
-    let docBody = this.#_getBody();
-    if (!docBody) {
-      let docRoot = this.#_getRoot();
-      if (!docRoot) docRoot = this.#_initRoot();
-      if (docRoot) {
+      // init a document body element
+      let docBody = getXObjElement(docRoot, XEPG_BODY_ETAG_NAME);
+      if (!docBody) {
         docBody = insertXObjElement(docRoot, XEPG_BODY_ETAG_NAME);
       };
+      if (docBody) {
+        if (typeof docBody[XEPG_SCHED_ETAG_NAME] !== 'object') {
+          docBody[XEPG_SCHED_ETAG_NAME] = [];
+        } else if (!isArray(docBody[XEPG_SCHED_ETAG_NAME])) {
+          let tmpObj = [];
+          tmpObj.push(docBody[XEPG_SCHED_ETAG_NAME]);
+          docBody[XEPG_SCHED_ETAG_NAME] = tmpObj;
+        };
+        //isSUCCEED = true;
+      };
+      if (docHdr && docBody) {
+        // init controllers
+        const hdrSect = new TXEpgHeaderContainer(docHdr, opt);
+        const schedSect = new TXEpgSchedulesList(
+          docBody[XEPG_SCHED_ETAG_NAME],
+          opt,
+          {
+            dts_src: getXObjElement(docHdr, XEPG_DTSINFO_ETAG_NAME),
+            tz_src: getXObjElement(docHdr, XEPG_DOCTZ_ETAG_NAME),
+          },
+        );
+        this.#_hdrSect = hdrSect;
+        this.#_schedSect = schedSect;
+      };
     };
-    return isPlainObject(docBody) ? docBody : null;
+    //==
+    return result;
   }
 
   /**
    * Returns a `TXEpgHeaderContainer` instance
    * @since 0.0.22
-   * @type {?TXEpgHeaderContainer}
+   * @type {TXEpgHeaderContainer}
    * @readonly
    */
   get header() {
-    const docHdr = this.#_getHdr();
-    return (
-      docHdr
-      ? new TXEpgHeaderContainer(docHdr, this.#_options)
-      : null
-    );
+    return this.#_hdrSect;
   }
 
   /**
@@ -1784,23 +1041,6 @@ class TXEpgContentProvider {
     return docHdr ? docHdr.dts : null;
   }
 
-  /* [!] a temporary special method */
-  /**
-   * @deprecated
-   */
-  get Content(){ return this; }
-
-  /**
-   * Returns a `TXEpgSchedulesList` instance
-   * @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
@@ -1808,56 +1048,27 @@ class TXEpgContentProvider {
    * @readonly
    */
   get schedules() {
-    const _options = this.#_options;
-    const docBody = this.#_getBody();
-    if (docBody && isArray(docBody[XEPG_SCHED_ETAG_NAME])) {
-      const docHdr = this.#_getHdr();
-      return new TXEpgSchedulesList(
-        docBody[XEPG_SCHED_ETAG_NAME],
-        {
-          dts_src: getXObjElement(docHdr, XEPG_DTSINFO_ETAG_NAME),
-          tz_src: getXObjElement(docHdr, XEPG_DOCTZ_ETAG_NAME),
-        },
-      );
-    };
+    return this.#_schedSect;
   }
 
   /**
    * @returns {void}
    */
   init() {
-    const _options = this.#_options;
-    const _content = this.#_content;
+    const config = this.#_options;
+    const content = this.#_content;
     const {
       parseOptions,
-    } = _options;
+    } = config;
     const { settings } = parseOptions;
-    const { ignoreDeclaration } = settings;
-    if (!ignoreDeclaration) {
-      // write document declaration section
-      writeXEpgDocDeclSection(_content);
-    };
-    // initiate document root element
-    let docRoot = this.#_getRoot();
-    if (!docRoot) docRoot = this.#_initRoot();
-    if (docRoot) {
-      // initiate document header element
-      let docHdr = this.#_getHdr();
-      if (!docHdr) docHdr = this.#_initHdr();
+    // initiate document content declaration element
+    this.#_docDecl.init();
+    // init document content
+    const { isERR } = this.#_initContent(content, config, true);
+    // // TODO: ...
+    if (!isERR) {
       // initiate document provider element
-      let docProv = insertXObjElement(
-        docHdr,
-        XEPG_PRVINFO_ETAG_NAME,
-      );
-      if (docProv) this.provider.init();
-      // initiate document body element
-      let docBody = this.#_getBody();
-      if (!docBody) docBody = this.#_initBody();
-      if (
-        docBody && !isArray(docBody[XEPG_SCHED_ETAG_NAME])
-      ) {
-        docBody[XEPG_SCHED_ETAG_NAME] = [];
-      };
+      this.provider.init();
     };
   }
 
@@ -1879,7 +1090,7 @@ class TXEpgContentProvider {
   /**
    * Saves a document content to a file.
    * @param {string} source - a path to a file
-   * @returns {Promise<fsoDescr, Error>}
+   * @returns {Promise<fsoDescr>}
    * @throws {Error}
    * @async
    */
@@ -1959,20 +1170,14 @@ class TXEpgContentProvider {
       const { parseOptions } = this.#_options;
       try {
         this.#_content = xmlParser.xml2js(xmlString, parseOptions.xml2js);
-        // init a document header element
-        let docHdr = this.#_getHdr();
-        if (!docHdr) docHdr = this.#_initHdr();
-        // init a document body element
-        let docBody = this.#_getBody();
-        if (!docBody) docBody = this.#_initBody();
-        if (docBody) {
-          if (typeof docBody[XEPG_SCHED_ETAG_NAME] !== 'object') {
-            docBody[XEPG_SCHED_ETAG_NAME] = [];
-          } else if (!isArray(docBody[XEPG_SCHED_ETAG_NAME])) {
-            let tmpObj = [];
-            tmpObj.push(docBody[XEPG_SCHED_ETAG_NAME]);
-            docBody[XEPG_SCHED_ETAG_NAME] = tmpObj;
-          };
+        // init a document content
+        const { isERR } = this.#_initContent(
+          this.#_content,
+          this.#_options,
+          false,
+        );
+        // // TODO: ...
+        if (!isERR) {
           isSUCCEED = true;
         };
       } catch (err) {
@@ -1986,7 +1191,7 @@ class TXEpgContentProvider {
   /**
    * Loads a document content from a file.
    * @param {string} source - path to a file
-   * @returns {Promise<fsoDescr, Error>}
+   * @returns {Promise<fsoDescr>}
    * @throws {Error}
    * @async
    */
@@ -1998,7 +1203,7 @@ class TXEpgContentProvider {
           if (data.content !== '') {
             if (this.loadFromXMLString(data.content)) {
               // // TODO:
-              data.isLoaded = true;
+              //data.isLoaded = true;
               data.errEvent = 'OPS_IS_SUCCEED';
             } else {
               data.isERR = true;
@@ -2029,7 +1234,7 @@ class TXEpgContentProvider {
       if (data.content !== '') {
         if (this.loadFromXMLString(data.content)) {
           // // TODO:
-          data.isLoaded = true;
+          //data.isLoaded = true;
           data.errEvent = 'OPS_IS_SUCCEED';
         } else {
           data.isERR = true;
@@ -2051,6 +1256,7 @@ class TXEpgContentProvider {
   }
 
 }
+module.exports.TXEpgContentProvider = TXEpgContentProvider;
 
 // === module exports block ===
 
@@ -2060,9 +1266,3 @@ module.exports.XEPG_DEF_DOCUMENT_TYPE = XEPG_DEF_DOCUMENT_TYPE;
 module.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;