@ygracs/xepg-lib-js 0.0.20 → 0.0.21

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+#### *v0.0.21*
+
+Pre-release version.
+
+> - update `xepgdoc-lib.md`;
+> - update dependency on `@ygracs/bsfoc-lib-js` module to v0.2.2;
+> - update dependency on `@ygracs/dtf-lib-js` module to v0.0.27;
+> - update dependency on `@ygracs/xobj-lib-js` module to v0.2.1;
+> - change name for class `TXepgDTSProvider` into `TXEpgDTSProvider`;
+> - remove method `asXML` for `TXEpgProviderContainer` class.
+
 #### *v0.0.20*
 
 Pre-release version.
@@ -96,81 +107,6 @@ Pre-release version.
 > - add `TXepgDTSProvider` class;
 > - deprecate property `SchedulesQty` of `TXEpgSchedulesList` class.
 
-#### *v0.0.10*
-
-Pre-release version.
-
-> - some fixes in `xepgdoc-lib.js` module.
-
-#### *v0.0.9*
-
-Pre-release version.
-
-> - `xepgdoc-lib.md` updated;
-> - `xepgdoc-spec.md` updated;
-> - some fixes in `xepgdoc-lib.js` module;
-> - some fixes in `dtFunc.js` module;
-> - `$module/lib/dts-helper.js` added;
-> - move module `xepgdoc-lib-v2.js` to its own project;
-> - updated dependency on `@cntwg/xml-lib-js` module to v0.0.13;
-> - updated dependency on `@ygracs/xml-js6` module to v0.0.3b.
-
-#### *v0.0.8*
-
-Pre-release version.
-
-> - updated dependency on `@cntwg/xml-lib-js` module to v0.0.10;
-> - switch dependency from `@cntwg/bsfoc-lib-js` module to `@ygracs/bsfoc-lib-js` module.
-
-#### *v0.0.7*
-
-Pre-release version.
-
-> - updated dependency on `@cntwg/bsfoc-lib-js` module to v0.0.11;
-> - updated dependency on `@cntwg/xml-lib-js` module to v0.0.9.
-
-#### *v0.0.6*
-
-Pre-release version.
-
-> - some fixes in `xepgdoc-lib.js` module.
-
-#### *v0.0.5*
-
-Pre-release version.
-
-> - updated dependency on `@cntwg/bsfoc-lib-js` module to v0.0.8;
-> - updated dependency on `@cntwg/xml-lib-js` module to v0.0.8;
-> - add method `loadFromFileSync` to `TXEpgContentProvider` (v1);
-> - add method `saveToFileSync` to `TXEpgContentProvider` (v1);
-> - some fixes in `xepgdoc-lib.js` module;
-> - `$module/lib/xepgdoc-lib-v2.js` added;
-> - `xepgdoc-lib-v2.md` added;
-> - `xepgdoc-spec.md` added.
-
-#### *v0.0.4*
-
-Pre-release version.
-
-> - removed class `TXEpgContentBodyContainer` from `xepgdoc-lib.js` module;
-> - merdged class `TXEpgContentContainer` into `TXEpgContentProvider`;
-> - `xepgdoc-lib.md` added.
-
-#### *v0.0.3*
-
-Pre-release version.
-
-> - updated dependency on `@cntwg/xml-lib-js` module to v0.0.7;
-> - renamed class `TXEpgScheduleContainer` to `TXEpgSchedulesList`;
-> - `xepgdoc-lib.md` added;
-> - MIT-license applied.
-
-#### *v0.0.2*
-
-Pre-release version.
-
-> - fixed some errors in `xepgdoc-lib.js` module.
-
-#### *v0.0.1*
+#### *v0.0.10-v0.0.1*
 
 Pre-release version.

package/LICENSE

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

package/README.md

@@ -1,6 +1,6 @@
-|***rev.*:**|0.0.6|
+|***rev.*:**|0.0.7|
 |:---|---:|
-|***date***:|2024-10-29|
+|***date***:|2025-02-28|
 
 ## Introduction
 
@@ -19,7 +19,7 @@ This module contains the following components:
 - classes:
 
 	+ `TXEpgSchedulesList`;
-	+ `TXepgDTSProvider`;
+	+ `TXEpgDTSProvider`;
 	+ `TXEpgProviderContainer`;
 	+ `TXEpgHeaderContainer`;
 	+ `TXEpgContentContainer`.

package/doc/xepgdoc-lib.md

@@ -1,15 +1,71 @@
-|***rev.*:**|0.0.15|
+|***rev.*:**|0.1.18|
 |:---|---:|
-|***date***:|2024-10-28|
+|***date***:|2025-02-27|
 
 ## Introduction
 
 This paper describes a constants and an object classes provided by `xepgdoc-lib.js` module.
 
+### Base type definitions
+
+This section contains some definitions for a general types of the objects (e.g. options set) that frequently used in a function or a class method descriptions.
+
+<a name="typedef+fsoDescr"></a>
+#### `fsoDescr` - descriptor
+
+This descriptor is an `object` that describes a status for an operation with some FS-object (*e.g. object such as a file*).
+
+| property name | value type | optional | description |
+|:---|---|---:|:---|
+| `isERR` | `boolean` | no | a flag which indicates whether an error was happen |
+| `errCode` | `number` | yes | an error code |
+| `errEvent` | `string` | no | an error event identifier |
+| `errMsg` | `string` | no | an error message |
+| `source` | `string` | no | path to a file |
+| `content` | `any` | no | content |
+
+<a name="typedef+xepgProvInfoDesc"></a>
+#### `xepgProvInfoDesc` - descriptor
+
+This descriptor is an `object` that describes a content provider.
+
+| property name | value type | optional | description |
+|:---|---|---:|:---|
+| `name` | `string` | yes | a provider name |
+| `version` | `string` | yes | a provider version |
+| `schema` | `string` | no | a document schema version |
+| `doctype` | `string` | no | a document type |
+
+<a name="typedef+xepgChnInfoDesc"></a>
+#### `xepgChnInfoDesc` - descriptor
+
+This descriptor is an `object` that describes a channel info.
+
+| property name | value type | optional | description |
+|:---|---|---:|:---|
+| `chnid` | `srting` | no | a channel ID |
+| `chname` | `string` | no | a name of the channel |
+| `chngid` | `string` | yes | a channel 'Group ID' |
+| `srcurl` | `string` | yes | a link to source |
+
+<a name="typedef+xepgShedInfoDesc"></a>
+#### `xepgShedInfoDesc` - descriptor
+
+This descriptor is an `object` that describes a content provider.
+
+| property name | value type | optional | description |
+|:---|---|---:|:---|
+| `time` | `number` | a schedule start time |
+| `title` | `string` | a schedule title |
+| `cat` | `string` | a schedule category |
+| `pcmark` | `number` | a schedule rating |
+| `descr` | `string` | a schedule description |
+
 ## Module constants
 
 ## Module classes
 
+<a name="TXEpgSchedulesList"></a>
 ### **TXEpgSchedulesList**
 
 This class provides a functionality for handle an EPG-schedules list.
@@ -22,7 +78,7 @@ The class constructor creates a new instance of the class.
 
 The class constructor receives arguments listed below:
 
-|name|type|default value|description|
+| parameter name | value type | default value | description |
 |:---|---|---:|:---|
 |`object`|`array`|---|a host object|
 |`options`|`object`|---|an options settings|
@@ -31,18 +87,35 @@ The class constructor receives arguments listed below:
 
 The table below describes a properties of a `TXEpgSchedulesList` class:
 
-|property name|property type|read only|description|
-|:---|---|---|:---|
-|`schedQty`|`number`|yes|returns a quantity of the elements|
-|`dtstype`|`index`|yes|returns a "dtstype"-value|
-|`curDocTZ`|`number`|yes|returns a current TimeZone|
+<a name="TXEpgSchedulesList+schedQty"></a>
+##### **schedQty**
+
+| property type | read only | description |
+|---|---|:---|
+| `number` | yes | contains a quantity of the elements the container holds |
+
+<a name="TXEpgSchedulesList+dtstype"></a>
+##### **dtstype**
+
+| property type | read only | description |
+|---|---|:---|
+| `number` | yes | contains a "dtstype"-value |
+
+<a name="TXEpgSchedulesList+curDocTZ"></a>
+##### **curDocTZ**
+
+| property type | read only | description |
+|---|---|:---|
+| `number` | yes | contains a current TimeZone |
 
 #### class methods
 
+<a name="TXEpgSchedulesList+hasNoSchedules"></a>
 ##### **hasNoSchedules()** => `boolean`
 
 This method returns `true` if a document contains no schedules.
 
+<a name="TXEpgSchedulesList+hasSchedules"></a>
 ##### **hasSchedules()** => `boolean`
 
 This method returns `true` if a document contains at least one schedule.
@@ -51,17 +124,28 @@ This method returns `true` if a document contains at least one schedule.
 
 > WARNING: This method deprecated (*since `v0.0.20`*). Use `chkIndex` instead.
 
+<a name="TXEpgSchedulesList+chkIndex"></a>
 ##### **chkIndex(value)** => `boolean`
 
 > since: `v0.0.20`
 
 This method checks if a given `value` represents a valid schedule index and if so returns `true`.
 
-##### **getScheduleInfo(index)** => `object`
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `value` | `number`, `string` | --- | a value to be verified |
+
+<a name="TXEpgSchedulesList+getScheduleInfo"></a>
+##### **getScheduleInfo(index)** => `xepgShedInfoDesc`
 
 This method returns an object that contains a schedule information.
 
-##### **getAllSchedulesInfo()** => `object[]`
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `index` | `number`, `string` | --- | an element index |
+
+<a name="TXEpgSchedulesList+getAllSchedulesInfo"></a>
+##### **getAllSchedulesInfo()** => `xepgShedInfoDesc[]`
 
 This method returns an array that contains an information for all available schedules.
 
@@ -69,6 +153,7 @@ This method returns an array that contains an information for all available sche
 
 ##### **asJSON()**
 
+<a name="TXEpgProviderContainer"></a>
 ### **TXEpgProviderContainer**
 
 This class implements a structure that holds an information about a program provider within which the content of the document was written.
@@ -94,22 +179,47 @@ The `options` structure is listed below:
 
 #### class properties
 
-The table below describes a properties of a `TXEpgProviderContainer` class:
+<a name="TXEpgProviderContainer+name"></a>
+##### **name**
 
-|property name|property type|read only|description|
-|:---|---|---|:---|
-|`name`|`string`|no|defines a provider name|
-|`version`|`string`|no|defines a provider version string|
-|`schema`|`string`|no|defines a document schema version|
-|`doctype`|`string`|no|defines a document type|
+| property type | read only | description |
+|---|---|:---|
+| `string` | no | contains a provider name |
+
+<a name="TXEpgProviderContainer+version"></a>
+##### **version**
+
+| property type | read only | description |
+|---|---|:---|
+| `string` | no | contains a provider version string |
+
+<a name="TXEpgProviderContainer+schema"></a>
+##### **schema**
+
+| property type | read only | description |
+|---|---|:---|
+| `string` | no | contains a document schema version |
+
+<a name="TXEpgProviderContainer+doctype"></a>
+##### **doctype**
+
+| property type | read only | description |
+|---|---|:---|
+| `string` | no | contains a document type |
 
 #### class methods
 
+<a name="TXEpgProviderContainer+setName"></a>
 ##### **setName(value)** => `boolean`
 
 This method sets a name of a provider to a given `value`.
 
-##### **getInfo()** => `object`
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `value` | `string` | --- | provider name |
+
+<a name="TXEpgProviderContainer+getInfo"></a>
+##### **getInfo()** => `xepgProvInfoDesc`
 
 This method returns an `object` that contains information about content provider. An object contains a field listed in the table below:
 
@@ -120,11 +230,16 @@ This method returns an `object` that contains information about content provider
 |`schema`|`string`|a document schema version|
 |`doctype`|`string`|a document type|
 
-
+<a name="TXEpgProviderContainer+setInfo"></a>
 ##### **setInfo(obj)** => `void`
 
 This method loads information about content provider.
 
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `obj` | `xepgProvInfoDesc` | --- | provider info descriptor |
+
+<a name="TXEpgProviderContainer+saveToXMLString"></a>
 ##### **saveToXMLString()** => `string`
 
 > since: `v0.0.20`
@@ -135,6 +250,7 @@ This method saves an element content to a string.
 
 ##### **init()**
 
+<a name="TXEpgDTSProvider"></a>
 ### **TXEpgDTSProvider**
 
 #### class constructor
@@ -158,13 +274,21 @@ The `options` structure is listed below:
 
 #### class properties
 
-The table below describes a properties of a `TXEpgDTSProvider` class:
+<a name="TXEpgDTSProvider+dtstype"></a>
+##### **dtstype**
+
+| property type | read only | description |
+|---|---|:---|
+| `number` | no | defines a "dtstype"-value |
 
-|property name|property type|read only|description|
-|:---|---|---|:---|
-|`dtstype`|`index`|no|defines a "dtstype"-value|
-|`curDocTZ`|`number`|no|defines a current TimeZone|
+<a name="TXEpgDTSProvider+curDocTZ"></a>
+##### **curDocTZ**
 
+| property type | read only | description |
+|---|---|:---|
+| `number` | no | defines a current TimeZone |
+
+<a name="TXEpgHeaderContainer"></a>
 ### **TXEpgHeaderContainer**
 
 #### class constructor
@@ -188,36 +312,64 @@ The `options` structure is listed below:
 
 #### class properties
 
-The table below describes a properties of a `TXEpgHeaderContainer` class:
+<a name="TXEpgHeaderContainer+dts"></a>
+##### **dts**
 
-|property name|property type|read only|description|
-|:---|---|---:|:---|
-|`dtstype`|`index`|no|defines a "dtstype"-value|
-|`curDocTZ`|`number`|no|defines a current TimeZone|
-|`Provider`|`TXEpgProviderContainer`|yes|returns a `TXEpgProviderContainer`|
-|`dts`|`TXepgDTSProvider`|yes|returns a `TXEpgDTSProvider`|
+| property type | read only | description |
+|---|---|:---|
+| `TXEpgDTSProvider` | yes | returns a `TXEpgDTSProvider` |
+
+<a name="TXEpgHeaderContainer+dtstype"></a>
+##### **dtstype**
+
+| property type | read only | description |
+|---|---|:---|
+| `number` | no | defines a "dtstype"-value |
+
+<a name="TXEpgHeaderContainer+curDocTZ"></a>
+##### **curDocTZ**
+
+| property type | read only | description |
+|---|---|:---|
+| `number` | no | defines a current TimeZone |
+
+<a name="TXEpgHeaderContainer+Provider"></a>
+##### **Provider**
+
+| property type | read only | description |
+|---|---|:---|
+| `TXEpgProviderContainer` | yes | returns a `TXEpgProviderContainer` |
 
 #### class methods
 
+<a name="TXEpgHeaderContainer+getDocumentDT"></a>
 ##### **getDocumentDT()** => `number`
 
 This method returns a time value of a document creation as a timestamp.
 
+<a name="TXEpgHeaderContainer+setDocumentDT"></a>
 ##### **setDocumentDT()** => `void`
 
 This method sets a time value of a document creation.
 
+<a name="TXEpgHeaderContainer+getDocumentEDT"></a>
 ##### **getDocumentEDT()** => `number`
 
 This method returns a time value from which a document is expired as a timestamp.
 
+<a name="TXEpgHeaderContainer+setDocumentEDT"></a>
 ##### **setDocumentEDT(value)** => `void`
 
 This method sets a time value at which a document will be expired.
 
-##### **getChannelInfo()** => `object`
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `value` | `number`, `string`, `Date` | --- | document expire time |
+
+<a name="TXEpgHeaderContainer+getChannelInfo"></a>
+##### **getChannelInfo()** => `xepgChnInfoDesc`
 
-This method returns an object which contains a channel information.
+This method returns an `object` which contains a channel information.
 
 An object contains the following fields:
 
@@ -228,10 +380,17 @@ An object contains the following fields:
 |`chname`|`string`|a name of the channel|
 |`srcurl`|`string`|a link to source|
 
+<a name="TXEpgHeaderContainer+setChannelInfo"></a>
 ##### **setChannelInfo(obj)** => `void`
 
 This method fills a channel information with a given data.
 
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `obj` | `xepgChnInfoDesc` | --- | channel info descriptor |
+
+> \[!] NOTE: `[since v0.0.21]` a use of a `string` or `array` types a as values of an `obj` are deprecated and will be dropped soon.
+
 The `obj` parameter can be a string or an array or an object.
 
 If a string is given it mean to contains the `chnid` value.
@@ -249,18 +408,21 @@ If an object is given it contains the following fields:
 |`chngid`|`string`|a channel group|
 |`srcurl`|`string`|a link to source|
 
-##### **getProviderInfo()** => `object`
+<a name="TXEpgHeaderContainer+getProviderInfo"></a>
+##### **getProviderInfo()** => `xepgProvInfoDesc`
 
 This method returns an object which contains an information about document provider.
 
 ##### **setProviderInfo(obj)**
 
+<a name="TXEpgHeaderContainer+saveToXMLString"></a>
 ##### **saveToXMLString()** => `string`
 
 > since: `v0.0.20`
 
 This method saves an element content to a string.
 
+<a name="TXEpgContentProvider"></a>
 ### **TXEpgContentProvider**
 
 #### class constructor
@@ -284,50 +446,93 @@ The `options` structure is listed below:
 
 #### class properties
 
-The table below describes a properties of a `TXEpgContentProvider` class:
+<a name="TXEpgContentProvider+Header"></a>
+##### **Header**
+
+| property type | read only | description |
+|---|---|:---|
+| `TXEpgHeaderContainer` | yes | returns a `TXEpgHeaderContainer` |
+
+<a name="TXEpgContentProvider+Provider"></a>
+##### **Provider**
+
+| property type | read only | description |
+|---|---|:---|
+| `TXEpgProviderContainer` | yes | returns a `TXEpgProviderContainer` |
 
-|property name|property type|read only|description|
-|:---|---|---|:---|
-|`Header`|`TXEpgHeaderContainer`|yes|returns a `TXEpgHeaderContainer`|
-|`Provider`|`TXEpgProviderContainer`|yes|returns a `TXEpgProviderContainer`|
-|`SchedulesList`|`TXEpgSchedulesList`|yes|returns a `TXEpgSchedulesList`|
-|`dts`|`TXEpgDTSProvider`|yes|returns a `TXEpgDTSProvider`|
+<a name="TXEpgContentProvider+dts"></a>
+##### **dts**
+
+| property type | read only | description |
+|---|---|:---|
+| `TXEpgDTSProvider` | yes | returns a `TXEpgDTSProvider` |
+
+<a name="TXEpgContentProvider+SchedulesList"></a>
+##### **SchedulesList**
+
+| property type | read only | description |
+|---|---|:---|
+| `TXEpgSchedulesList` | yes | returns a `TXEpgSchedulesList` |
 
 #### class methods
 
+<a name="TXEpgContentProvider+saveToXMLString"></a>
+##### **saveToXMLString()** => `string`
+
+This method saves a document content to a string.
+
+<a name="TXEpgContentProvider+saveToFileSync"></a>
+##### **saveToFileSync(src)** => `fsoDescr`
+
+This method saves a document content into a file addressed by `src`.
+
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `src` | `string` | --- | path to a file |
+
 ##### **loadFromString(xmlString, options)** => `boolean`
 
 > WARNING: This method deprecated (*since `v0.0.18`*). Use `loadFromXMLString` instead.
 
-##### **loadFromXMLString(xmlString, options)** => `boolean`
+<a name="TXEpgContentProvider+loadFromXMLString"></a>
+##### **loadFromXMLString(str)** => `boolean`
 
 > since: `v0.0.18`
 
-This method loads a document content from string containing text in XML format.
-
-##### **loadFromFile(src)** => `object`
+This method loads a document content from a string given by `str`.
 
-This method loads a document content from a file. A `src` provided a string that is a path to the file.
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `str` | `string` | --- | some content |
 
-##### **loadFromFileSync(src)** => `object`
+<a name="TXEpgContentProvider+loadFromFileSync"></a>
+##### **loadFromFileSync(src)** => `fsoDescr`
 
-This method loads a document content from a file. A `src` provided a string that is a path to the file.
+This method loads a document content from a file addressed by `src`.
 
-##### **saveToXMLString()** => `string`
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `src` | `string` | --- | path to a file |
 
-This method saves a document content to a string.
+#### class methods (*async*)
 
-##### **saveToFile(src)** => `object`
+<a name="TXEpgContentProvider+saveToFile"></a>
+##### **saveToFile(src)** => `Promise<fsoDescr, Error>`
 
-This method saves a document content to a file. A `src` provided a string that is a path to the file.
+This method saves a document content into a file addressed by `src`.
 
-##### **saveToFileSync(src)** => `object`
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `src` | `string` | --- | path to a file |
 
-This method saves a document content to a file. A `src` provided a string that is a path to the file.
+<a name="TXEpgContentProvider+loadFromFile"></a>
+##### **loadFromFile(src)** => `Promise<fsoDescr, Error>`
 
-##### **asXML(options)**
+This method loads a document content from a file addressed by `src`.
 
-> WARNING: This method deprecated (*since `v0.0.18`*). Use `saveToXMLString` instead.
+| parameter name | value type | default value | description |
+|:---|---|---:|:---|
+| `src` | `string` | --- | path to a file |
 
 #### class methods (*special*)
 

package/doc/xepgdoc-spec-draft.dtd

@@ -0,0 +1,65 @@
+<!-- DTD for TV-listings
+     ======================
+     * [rev.0.2.002-20241016]
+     * [schema 0.2]         -->
+
+<!ELEMENT epgdoc (tvp:info, tvp:list)>
+<!ATTLIST epgdoc xmlns:tvp CDATA #REQUIRED >
+
+<!ELEMENT tvp:info (tvp:provider,
+                    (tvp:channel?|(tvp:chnid, tvp:chngid?, tvp:chname)),
+                    tvp:srcurl?,
+                    tvp:time?, tvp:expire?, tvp:timezone, tvp:dtstype)>
+
+<!ELEMENT tvp:provider (name, version?, tvp:schema, tvp:doctype)>
+
+<!ELEMENT name (#PCDATA)>
+<!ATTLIST name lang CDATA #IMPLIED >
+
+<!ELEMENT version (#PCDATA)>
+
+<!ELEMENT tvp:schema (#PCDATA)>
+
+<!ELEMENT tvp:doctype (#PCDATA)>
+
+<!-- NOTE: tag <tvp:channel> reserved for schema 0.3+ -->
+<!ELEMENT tvp:channel (tvp:chnid, tvp:chngid?, tvp:chname*)>
+
+<!ELEMENT tvp:chnid (#PCDATA)>
+
+<!ELEMENT tvp:chngid (#PCDATA)>
+
+<!ELEMENT tvp:chname (#PCDATA)>
+<!ATTLIST tvp:chname lang CDATA #IMPLIED >
+
+<!ELEMENT tvp:srcurl (#PCDATA)>
+
+<!ELEMENT tvp:time (#PCDATA)>
+
+<!ELEMENT tvp:expire (#PCDATA)>
+
+<!ELEMENT tvp:timezone (#PCDATA)>
+
+<!ELEMENT tvp:dtstype (value, name)>
+
+<!ELEMENT value (#PCDATA)>
+
+<!ELEMENT tvp:list ((tvp:item|tvp:schedule)*)>
+
+<!ELEMENT tvp:item (tvp:time, tvp:title+, tvp:pcmark?, tvp:cat*, tvp:desc*)>
+
+<!ELEMENT tvp:title (#PCDATA)>
+<!ATTLIST tvp:chname lang CDATA #IMPLIED >
+
+<!ELEMENT tvp:pcmark (#PCDATA)>
+
+<!ELEMENT tvp:cat (#PCDATA)>
+<!ATTLIST tvp:cat lang CDATA #IMPLIED >
+
+<!ELEMENT tvp:desc (#PCDATA)>
+<!ATTLIST tvp:desc lang CDATA #IMPLIED >
+
+<!-- NOTE: tag <tvp:channel> reserved for schema 0.3+ -->
+<!ELEMENT tvp:schedule (tvp:title+, tvp:pcmark?, tvp:cat*, tvp:desc*)>
+<!ATTLIST tvp:schedule start CDATA #REQUIRED
+                       stop CDATA #IMPLIED >