music-metadata 11.10.5 → 11.11.0

package/README.md

@@ -1,12 +1,11 @@
 [![CI](https://github.com/Borewit/music-metadata/actions/workflows/ci.yml/badge.svg)](https://github.com/Borewit/music-metadata/actions/workflows/ci.yml)
 [![NPM version](https://img.shields.io/npm/v/music-metadata.svg)](https://npmjs.org/package/music-metadata)
-[![npm downloads](http://img.shields.io/npm/dm/music-metadata.svg)](https://npmcharts.com/compare/music-metadata?start=600&interval=30)
+[![npm downloads](http://img.shields.io/npm/dm/music-metadata.svg)](https://npmcharts.com/compare/music-metadata?start=600&interval=7)
 [![Coverage Status](https://coveralls.io/repos/github/Borewit/music-metadata/badge.svg?branch=master)](https://coveralls.io/github/Borewit/music-metadata?branch=master)
 [![Codacy Badge](https://api.codacy.com/project/badge/Grade/57d731b05c9e41889a2a17cb4b0384d7)](https://app.codacy.com/app/Borewit/music-metadata?utm_source=github.com&utm_medium=referral&utm_content=Borewit/music-metadata&utm_campaign=Badge_Grade_Dashboard)
 [![CodeQL](https://github.com/Borewit/music-metadata/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/Borewit/music-metadata/actions/workflows/codeql-analysis.yml)
 [![DeepScan grade](https://deepscan.io/api/teams/5165/projects/6938/branches/61821/badge/grade.svg)](https://deepscan.io/dashboard#view=project&tid=5165&pid=6938&bid=61821)
 [![Known Vulnerabilities](https://snyk.io/test/github/Borewit/music-metadata/badge.svg?targetFile=package.json)](https://snyk.io/test/github/Borewit/music-metadata?targetFile=package.json)
-[![Discord](https://img.shields.io/discord/460524735235883049.svg)](https://discord.gg/KyBr6sb)
 
 # music-metadata
 
@@ -74,7 +73,7 @@ Following tag header formats are supported:
 - [APE](https://wikipedia.org/wiki/APE_tag)
 - [ASF](https://wikipedia.org/wiki/Advanced_Systems_Format)
 - EXIF 2.3
-- [ID3](https://wikipedia.org/wiki/ID3): ID3v1, ID3v1.1, ID3v2.2, [ID3v2.3](http://id3.org/id3v2.3.0) & [ID3v2.4](http://id3.org/id3v2.4.0-frames)
+- [ID3](https://wikipedia.org/wiki/ID3): ID3v1, ID3v1.1, ID3v2.2, [ID3v2.3](http://id3.org/id3v2.3.0), [ID3v2.4](http://id3.org/id3v2.4.0-frames) and [ID3v2 Chapters 1.0](https://mutagen-specs.readthedocs.io/en/latest/id3/id3v2-chapters-1.0.html)
 - [iTunes](https://github.com/sergiomb2/libmp4v2/wiki/iTunesMetadata)
 - [RIFF](https://wikipedia.org/wiki/Resource_Interchange_File_Format)/INFO
 - [Vorbis comment](https://wikipedia.org/wiki/Vorbis_comment)

package/lib/asf/AsfGuid.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Ref:
+ * - https://tools.ietf.org/html/draft-fleischman-asf-01, Appendix A: ASF GUIDs
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/index.html
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
+ *
+ * ASF File Structure:
+ * - https://msdn.microsoft.com/en-us/library/windows/desktop/ee663575(v=vs.85).aspx
+ *
+ * ASF GUIDs:
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
+ * - https://github.com/dji-sdk/FFmpeg/blob/master/libavformat/asf.c
+ */
+export default class AsfGuid {
+    static HeaderObject: AsfGuid;
+    static DataObject: AsfGuid;
+    static SimpleIndexObject: AsfGuid;
+    static IndexObject: AsfGuid;
+    static MediaObjectIndexObject: AsfGuid;
+    static TimecodeIndexObject: AsfGuid;
+    static FilePropertiesObject: AsfGuid;
+    static StreamPropertiesObject: AsfGuid;
+    static HeaderExtensionObject: AsfGuid;
+    static CodecListObject: AsfGuid;
+    static ScriptCommandObject: AsfGuid;
+    static MarkerObject: AsfGuid;
+    static BitrateMutualExclusionObject: AsfGuid;
+    static ErrorCorrectionObject: AsfGuid;
+    static ContentDescriptionObject: AsfGuid;
+    static ExtendedContentDescriptionObject: AsfGuid;
+    static ContentBrandingObject: AsfGuid;
+    static StreamBitratePropertiesObject: AsfGuid;
+    static ContentEncryptionObject: AsfGuid;
+    static ExtendedContentEncryptionObject: AsfGuid;
+    static DigitalSignatureObject: AsfGuid;
+    static PaddingObject: AsfGuid;
+    static ExtendedStreamPropertiesObject: AsfGuid;
+    static AdvancedMutualExclusionObject: AsfGuid;
+    static GroupMutualExclusionObject: AsfGuid;
+    static StreamPrioritizationObject: AsfGuid;
+    static BandwidthSharingObject: AsfGuid;
+    static LanguageListObject: AsfGuid;
+    static MetadataObject: AsfGuid;
+    static MetadataLibraryObject: AsfGuid;
+    static IndexParametersObject: AsfGuid;
+    static MediaObjectIndexParametersObject: AsfGuid;
+    static TimecodeIndexParametersObject: AsfGuid;
+    static CompatibilityObject: AsfGuid;
+    static AdvancedContentEncryptionObject: AsfGuid;
+    static AudioMedia: AsfGuid;
+    static VideoMedia: AsfGuid;
+    static CommandMedia: AsfGuid;
+    static JFIF_Media: AsfGuid;
+    static Degradable_JPEG_Media: AsfGuid;
+    static FileTransferMedia: AsfGuid;
+    static BinaryMedia: AsfGuid;
+    static ASF_Index_Placeholder_Object: AsfGuid;
+    static fromBin(bin: Uint8Array, offset?: number): AsfGuid;
+    /**
+     * Decode GUID in format like "B503BF5F-2EA9-CF11-8EE3-00C00C205365"
+     * @param objectId Binary GUID
+     * @param offset Read offset in bytes, default 0
+     * @returns GUID as dashed hexadecimal representation
+     */
+    static decode(objectId: Uint8Array, offset?: number): string;
+    /**
+     * Decode stream type
+     * @param mediaType Media type GUID
+     * @returns Media type
+     */
+    static decodeMediaType(mediaType: AsfGuid): 'audio' | 'video' | 'command' | 'degradable-jpeg' | 'file-transfer' | 'binary' | undefined;
+    /**
+     * Encode GUID
+     * @param guid GUID like: "B503BF5F-2EA9-CF11-8EE3-00C00C205365"
+     * @returns Encoded Binary GUID
+     */
+    static encode(guid: string): Uint8Array;
+    str: string;
+    constructor(str: string);
+    equals(guid: AsfGuid): boolean;
+    toBin(): Uint8Array;
+}

package/lib/asf/AsfGuid.js

@@ -0,0 +1,109 @@
+import { parseWindowsGuid, Guid } from 'win-guid';
+/**
+ * Ref:
+ * - https://tools.ietf.org/html/draft-fleischman-asf-01, Appendix A: ASF GUIDs
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/index.html
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
+ *
+ * ASF File Structure:
+ * - https://msdn.microsoft.com/en-us/library/windows/desktop/ee663575(v=vs.85).aspx
+ *
+ * ASF GUIDs:
+ * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
+ * - https://github.com/dji-sdk/FFmpeg/blob/master/libavformat/asf.c
+ */
+class AsfGuid {
+    static fromBin(bin, offset = 0) {
+        return new AsfGuid(AsfGuid.decode(bin, offset));
+    }
+    /**
+     * Decode GUID in format like "B503BF5F-2EA9-CF11-8EE3-00C00C205365"
+     * @param objectId Binary GUID
+     * @param offset Read offset in bytes, default 0
+     * @returns GUID as dashed hexadecimal representation
+     */
+    static decode(objectId, offset = 0) {
+        return new Guid(objectId.subarray(offset, offset + 16)).toString();
+    }
+    /**
+     * Decode stream type
+     * @param mediaType Media type GUID
+     * @returns Media type
+     */
+    static decodeMediaType(mediaType) {
+        switch (mediaType.str) {
+            case AsfGuid.AudioMedia.str: return 'audio';
+            case AsfGuid.VideoMedia.str: return 'video';
+            case AsfGuid.CommandMedia.str: return 'command';
+            case AsfGuid.Degradable_JPEG_Media.str: return 'degradable-jpeg';
+            case AsfGuid.FileTransferMedia.str: return 'file-transfer';
+            case AsfGuid.BinaryMedia.str: return 'binary';
+        }
+    }
+    /**
+     * Encode GUID
+     * @param guid GUID like: "B503BF5F-2EA9-CF11-8EE3-00C00C205365"
+     * @returns Encoded Binary GUID
+     */
+    static encode(guid) {
+        return parseWindowsGuid(guid);
+    }
+    constructor(str) {
+        this.str = str;
+    }
+    equals(guid) {
+        return this.str === guid.str;
+    }
+    toBin() {
+        return AsfGuid.encode(this.str);
+    }
+}
+// 10.1 Top-level ASF object GUIDs
+AsfGuid.HeaderObject = new AsfGuid("75B22630-668E-11CF-A6D9-00AA0062CE6C");
+AsfGuid.DataObject = new AsfGuid("75B22636-668E-11CF-A6D9-00AA0062CE6C");
+AsfGuid.SimpleIndexObject = new AsfGuid("33000890-E5B1-11CF-89F4-00A0C90349CB");
+AsfGuid.IndexObject = new AsfGuid("D6E229D3-35DA-11D1-9034-00A0C90349BE");
+AsfGuid.MediaObjectIndexObject = new AsfGuid("FEB103F8-12AD-4C64-840F-2A1D2F7AD48C");
+AsfGuid.TimecodeIndexObject = new AsfGuid("3CB73FD0-0C4A-4803-953D-EDF7B6228F0C");
+// 10.2 Header Object GUIDs
+AsfGuid.FilePropertiesObject = new AsfGuid("8CABDCA1-A947-11CF-8EE4-00C00C205365");
+AsfGuid.StreamPropertiesObject = new AsfGuid("B7DC0791-A9B7-11CF-8EE6-00C00C205365");
+AsfGuid.HeaderExtensionObject = new AsfGuid("5FBF03B5-A92E-11CF-8EE3-00C00C205365");
+AsfGuid.CodecListObject = new AsfGuid("86D15240-311D-11D0-A3A4-00A0C90348F6");
+AsfGuid.ScriptCommandObject = new AsfGuid("1EFB1A30-0B62-11D0-A39B-00A0C90348F6");
+AsfGuid.MarkerObject = new AsfGuid("F487CD01-A951-11CF-8EE6-00C00C205365");
+AsfGuid.BitrateMutualExclusionObject = new AsfGuid("D6E229DC-35DA-11D1-9034-00A0C90349BE");
+AsfGuid.ErrorCorrectionObject = new AsfGuid("75B22635-668E-11CF-A6D9-00AA0062CE6C");
+AsfGuid.ContentDescriptionObject = new AsfGuid("75B22633-668E-11CF-A6D9-00AA0062CE6C");
+AsfGuid.ExtendedContentDescriptionObject = new AsfGuid("D2D0A440-E307-11D2-97F0-00A0C95EA850");
+AsfGuid.ContentBrandingObject = new AsfGuid("2211B3FA-BD23-11D2-B4B7-00A0C955FC6E");
+AsfGuid.StreamBitratePropertiesObject = new AsfGuid("7BF875CE-468D-11D1-8D82-006097C9A2B2");
+AsfGuid.ContentEncryptionObject = new AsfGuid("2211B3FB-BD23-11D2-B4B7-00A0C955FC6E");
+AsfGuid.ExtendedContentEncryptionObject = new AsfGuid("298AE614-2622-4C17-B935-DAE07EE9289C");
+AsfGuid.DigitalSignatureObject = new AsfGuid("2211B3FC-BD23-11D2-B4B7-00A0C955FC6E");
+AsfGuid.PaddingObject = new AsfGuid("1806D474-CADF-4509-A4BA-9AABCB96AAE8");
+// 10.3 Header Extension Object GUIDs
+AsfGuid.ExtendedStreamPropertiesObject = new AsfGuid("14E6A5CB-C672-4332-8399-A96952065B5A");
+AsfGuid.AdvancedMutualExclusionObject = new AsfGuid("A08649CF-4775-4670-8A16-6E35357566CD");
+AsfGuid.GroupMutualExclusionObject = new AsfGuid("D1465A40-5A79-4338-B71B-E36B8FD6C249");
+AsfGuid.StreamPrioritizationObject = new AsfGuid("D4FED15B-88D3-454F-81F0-ED5C45999E24");
+AsfGuid.BandwidthSharingObject = new AsfGuid("A69609E6-517B-11D2-B6AF-00C04FD908E9");
+AsfGuid.LanguageListObject = new AsfGuid("7C4346A9-EFE0-4BFC-B229-393EDE415C85");
+AsfGuid.MetadataObject = new AsfGuid("C5F8CBEA-5BAF-4877-8467-AA8C44FA4CCA");
+AsfGuid.MetadataLibraryObject = new AsfGuid("44231C94-9498-49D1-A141-1D134E457054");
+AsfGuid.IndexParametersObject = new AsfGuid("D6E229DF-35DA-11D1-9034-00A0C90349BE");
+AsfGuid.MediaObjectIndexParametersObject = new AsfGuid("6B203BAD-3F11-48E4-ACA8-D7613DE2CFA7");
+AsfGuid.TimecodeIndexParametersObject = new AsfGuid("F55E496D-9797-4B5D-8C8B-604DFE9BFB24");
+AsfGuid.CompatibilityObject = new AsfGuid("26F18B5D-4584-47EC-9F5F-0E651F0452C9");
+AsfGuid.AdvancedContentEncryptionObject = new AsfGuid("43058533-6981-49E6-9B74-AD12CB86D58C");
+// 10.4 Stream Properties Object Stream Type GUIDs
+AsfGuid.AudioMedia = new AsfGuid("F8699E40-5B4D-11CF-A8FD-00805F5C442B");
+AsfGuid.VideoMedia = new AsfGuid("BC19EFC0-5B4D-11CF-A8FD-00805F5C442B");
+AsfGuid.CommandMedia = new AsfGuid("59DACFC0-59E6-11D0-A3AC-00A0C90348F6");
+AsfGuid.JFIF_Media = new AsfGuid("B61BE100-5B4E-11CF-A8FD-00805F5C442B");
+AsfGuid.Degradable_JPEG_Media = new AsfGuid("35907DE0-E415-11CF-A917-00805F5C442B");
+AsfGuid.FileTransferMedia = new AsfGuid("91BD222C-F21C-497A-8B6D-5AA86BFC0185");
+AsfGuid.BinaryMedia = new AsfGuid("3AFB65E2-47EF-40F2-AC2C-70A90D71D343");
+AsfGuid.ASF_Index_Placeholder_Object = new AsfGuid("D9AADE20-7C17-4F9C-BC28-8555DD98E2A2");
+export default AsfGuid;

package/lib/asf/AsfObject.d.ts

@@ -1,6 +1,6 @@
 import type { IGetToken, ITokenizer } from 'strtok3';
 import type { AnyTagValue, IPicture, ITag } from '../type.js';
-import GUID from './GUID.js';
+import AsfGuid from './AsfGuid.js';
 declare const AsfContentParseError_base: {
     new (message: string): {
         readonly fileType: string;
@@ -52,7 +52,7 @@ export interface IAsfObjectHeader {
     /**
      * A GUID that identifies the object. 128 bits
      */
-    objectId: GUID;
+    objectId: AsfGuid;
     /**
      * The size of the object (64-bits)
      */
@@ -95,7 +95,7 @@ export interface IFilePropertiesObject {
      * The value of this field shall be regenerated every time the file is modified in any way.
      * The value of this field shall be identical to the value of the File ID field of the Data Object.
      */
-    fileId: GUID;
+    fileId: AsfGuid;
     /**
      * Specifies the size, in bytes, of the entire file.
      * The value of this field is invalid if the Broadcast Flag bit in the Flags field is set to 1.
@@ -186,7 +186,7 @@ export interface IFilePropertiesObject {
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/03_asf_top_level_header_object.html#3_2
  */
 export declare class FilePropertiesObject extends State<IFilePropertiesObject> {
-    static guid: GUID;
+    static guid: AsfGuid;
     get(buf: Uint8Array, off: number): IFilePropertiesObject;
 }
 /**
@@ -200,18 +200,18 @@ export interface IStreamPropertiesObject {
     /**
      * Error Correction Type
      */
-    errorCorrectionType: GUID;
+    errorCorrectionType: AsfGuid;
 }
 /**
  * Token for: 3.3 Stream Properties Object (mandatory, one per stream)
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/03_asf_top_level_header_object.html#3_3
  */
 export declare class StreamPropertiesObject extends State<IStreamPropertiesObject> {
-    static guid: GUID;
+    static guid: AsfGuid;
     get(buf: Uint8Array, off: number): IStreamPropertiesObject;
 }
 export interface IHeaderExtensionObject {
-    reserved1: GUID;
+    reserved1: AsfGuid;
     reserved2: number;
     extensionDataSize: number;
 }
@@ -220,7 +220,7 @@ export interface IHeaderExtensionObject {
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/03_asf_top_level_header_object.html#3_4
  */
 export declare class HeaderExtensionObject implements IGetToken<IHeaderExtensionObject> {
-    static guid: GUID;
+    static guid: AsfGuid;
     len: number;
     constructor();
     get(buf: Uint8Array, off: number): IHeaderExtensionObject;
@@ -244,7 +244,7 @@ export declare function readCodecEntries(tokenizer: ITokenizer): Promise<ICodecE
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/03_asf_top_level_header_object.html#3_10
  */
 export declare class ContentDescriptionObjectState extends State<ITag[]> {
-    static guid: GUID;
+    static guid: AsfGuid;
     private static contentDescTags;
     get(buf: Uint8Array, off: number): ITag[];
 }
@@ -253,7 +253,7 @@ export declare class ContentDescriptionObjectState extends State<ITag[]> {
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/03_asf_top_level_header_object.html#3_11
  */
 export declare class ExtendedContentDescriptionObjectState extends State<ITag[]> {
-    static guid: GUID;
+    static guid: AsfGuid;
     get(buf: Uint8Array, off: number): ITag[];
 }
 export interface IStreamName {
@@ -292,7 +292,7 @@ export interface IExtendedStreamPropertiesObject {
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/04_objects_in_the_asf_header_extension_object.html#4_1
  */
 export declare class ExtendedStreamPropertiesObjectState extends State<IExtendedStreamPropertiesObject> {
-    static guid: GUID;
+    static guid: AsfGuid;
     get(buf: Uint8Array, off: number): IExtendedStreamPropertiesObject;
 }
 /**
@@ -300,11 +300,11 @@ export declare class ExtendedStreamPropertiesObjectState extends State<IExtended
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/04_objects_in_the_asf_header_extension_object.html#4_7
  */
 export declare class MetadataObjectState extends State<ITag[]> {
-    static guid: GUID;
+    static guid: AsfGuid;
     get(uint8Array: Uint8Array, off: number): ITag[];
 }
 export declare class MetadataLibraryObjectState extends MetadataObjectState {
-    static guid: GUID;
+    static guid: AsfGuid;
 }
 export interface IWmPicture extends IPicture {
     type: string;

package/lib/asf/AsfObject.js

@@ -1,7 +1,7 @@
 // ASF Objects
 import * as Token from 'token-types';
 import * as util from '../common/Util.js';
-import GUID from './GUID.js';
+import AsfGuid from './AsfGuid.js';
 import { getParserForAttr, parseUnicodeAttr } from './AsfUtil.js';
 import { AttachedPictureType } from '../id3v2/ID3v2Token.js';
 import { makeUnexpectedFileContentError } from '../ParseError.js';
@@ -44,7 +44,7 @@ export const TopLevelHeaderObjectToken = {
     len: 30,
     get: (buf, off) => {
         return {
-            objectId: GUID.fromBin(buf, off),
+            objectId: AsfGuid.fromBin(buf, off),
             objectSize: Number(Token.UINT64_LE.get(buf, off + 16)),
             numberOfHeaderObjects: Token.UINT32_LE.get(buf, off + 24)
             // Reserved: 2 bytes
@@ -59,7 +59,7 @@ export const HeaderObjectToken = {
     len: 24,
     get: (buf, off) => {
         return {
-            objectId: GUID.fromBin(buf, off),
+            objectId: AsfGuid.fromBin(buf, off),
             objectSize: Number(Token.UINT64_LE.get(buf, off + 16))
         };
     }
@@ -94,7 +94,7 @@ export class IgnoreObjectState extends State {
 export class FilePropertiesObject extends State {
     get(buf, off) {
         return {
-            fileId: GUID.fromBin(buf, off),
+            fileId: AsfGuid.fromBin(buf, off),
             fileSize: Token.UINT64_LE.get(buf, off + 16),
             creationDate: Token.UINT64_LE.get(buf, off + 24),
             dataPacketsCount: Token.UINT64_LE.get(buf, off + 32),
@@ -112,7 +112,7 @@ export class FilePropertiesObject extends State {
         };
     }
 }
-FilePropertiesObject.guid = GUID.FilePropertiesObject;
+FilePropertiesObject.guid = AsfGuid.FilePropertiesObject;
 /**
  * Token for: 3.3 Stream Properties Object (mandatory, one per stream)
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/03_asf_top_level_header_object.html#3_3
@@ -120,13 +120,13 @@ FilePropertiesObject.guid = GUID.FilePropertiesObject;
 export class StreamPropertiesObject extends State {
     get(buf, off) {
         return {
-            streamType: GUID.decodeMediaType(GUID.fromBin(buf, off)),
-            errorCorrectionType: GUID.fromBin(buf, off + 8)
+            streamType: AsfGuid.decodeMediaType(AsfGuid.fromBin(buf, off)),
+            errorCorrectionType: AsfGuid.fromBin(buf, off + 8)
             // ToDo
         };
     }
 }
-StreamPropertiesObject.guid = GUID.StreamPropertiesObject;
+StreamPropertiesObject.guid = AsfGuid.StreamPropertiesObject;
 /**
  * 3.4: Header Extension Object (mandatory, one only)
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/03_asf_top_level_header_object.html#3_4
@@ -138,13 +138,13 @@ export class HeaderExtensionObject {
     get(buf, off) {
         const view = new DataView(buf.buffer, off);
         return {
-            reserved1: GUID.fromBin(buf, off),
+            reserved1: AsfGuid.fromBin(buf, off),
             reserved2: view.getUint16(16, true),
             extensionDataSize: view.getUint16(18, true)
         };
     }
 }
-HeaderExtensionObject.guid = GUID.HeaderExtensionObject;
+HeaderExtensionObject.guid = AsfGuid.HeaderExtensionObject;
 /**
  * 3.5: The Codec List Object provides user-friendly information about the codecs and formats used to encode the content found in the ASF file.
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/03_asf_top_level_header_object.html#3_5
@@ -217,7 +217,7 @@ export class ContentDescriptionObjectState extends State {
         return tags;
     }
 }
-ContentDescriptionObjectState.guid = GUID.ContentDescriptionObject;
+ContentDescriptionObjectState.guid = AsfGuid.ContentDescriptionObject;
 ContentDescriptionObjectState.contentDescTags = ['Title', 'Author', 'Copyright', 'Description', 'Rating'];
 /**
  * 3.11 Extended Content Description Object (optional, one only)
@@ -245,7 +245,7 @@ export class ExtendedContentDescriptionObjectState extends State {
         return tags;
     }
 }
-ExtendedContentDescriptionObjectState.guid = GUID.ExtendedContentDescriptionObject;
+ExtendedContentDescriptionObjectState.guid = AsfGuid.ExtendedContentDescriptionObject;
 /**
  * 4.1 Extended Stream Properties Object (optional, 1 per media stream)
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/04_objects_in_the_asf_header_extension_object.html#4_1
@@ -279,7 +279,7 @@ export class ExtendedStreamPropertiesObjectState extends State {
         };
     }
 }
-ExtendedStreamPropertiesObjectState.guid = GUID.ExtendedStreamPropertiesObject;
+ExtendedStreamPropertiesObjectState.guid = AsfGuid.ExtendedStreamPropertiesObject;
 /**
  * 4.7  Metadata Object (optional, 0 or 1)
  * Ref: http://drang.s4.xrea.com/program/tips/id3tag/wmp/04_objects_in_the_asf_header_extension_object.html#4_7
@@ -307,11 +307,11 @@ export class MetadataObjectState extends State {
         return tags;
     }
 }
-MetadataObjectState.guid = GUID.MetadataObject;
+MetadataObjectState.guid = AsfGuid.MetadataObject;
 // 4.8	Metadata Library Object (optional, 0 or 1)
 export class MetadataLibraryObjectState extends MetadataObjectState {
 }
-MetadataLibraryObjectState.guid = GUID.MetadataLibraryObject;
+MetadataLibraryObjectState.guid = AsfGuid.MetadataLibraryObject;
 /**
  * Ref: https://msdn.microsoft.com/en-us/library/windows/desktop/dd757977(v=vs.85).aspx
  */

package/lib/asf/AsfParser.js

@@ -1,6 +1,6 @@
 import initDebug from 'debug';
 import { TrackType } from '../type.js';
-import GUID from './GUID.js';
+import AsfGuid from './AsfGuid.js';
 import * as AsfObject from './AsfObject.js';
 import { BasicParser } from '../common/BasicParser.js';
 import { AsfContentParseError } from './AsfObject.js';
@@ -19,7 +19,7 @@ const headerType = 'asf';
 export class AsfParser extends BasicParser {
     async parse() {
         const header = await this.tokenizer.readToken(AsfObject.TopLevelHeaderObjectToken);
-        if (!header.objectId.equals(GUID.HeaderObject)) {
+        if (!header.objectId.equals(AsfGuid.HeaderObject)) {
             throw new AsfContentParseError(`expected asf header; but was not found; got: ${header.objectId.str}`);
         }
         try {
@@ -61,7 +61,7 @@ export class AsfParser extends BasicParser {
                     tags = await this.tokenizer.readToken(new AsfObject.ExtendedContentDescriptionObjectState(header));
                     await this.addTags(tags);
                     break;
-                case GUID.CodecListObject.str: {
+                case AsfGuid.CodecListObject.str: {
                     const codecs = await AsfObject.readCodecEntries(this.tokenizer);
                     codecs.forEach(codec => {
                         this.metadata.addStreamInfo({
@@ -73,11 +73,11 @@ export class AsfParser extends BasicParser {
                     this.metadata.setFormat('codec', audioCodecs);
                     break;
                 }
-                case GUID.StreamBitratePropertiesObject.str:
+                case AsfGuid.StreamBitratePropertiesObject.str:
                     // ToDo?
                     await this.tokenizer.ignore(header.objectSize - AsfObject.HeaderObjectToken.len);
                     break;
-                case GUID.PaddingObject.str:
+                case AsfGuid.PaddingObject.str:
                     // ToDo: register bytes pad
                     debug('Padding: %s bytes', header.objectSize - AsfObject.HeaderObjectToken.len);
                     await this.tokenizer.ignore(header.objectSize - AsfObject.HeaderObjectToken.len);
@@ -114,14 +114,14 @@ export class AsfParser extends BasicParser {
                     await this.addTags(mlTags);
                     break;
                 }
-                case GUID.PaddingObject.str:
+                case AsfGuid.PaddingObject.str:
                     // ToDo: register bytes pad
                     await this.tokenizer.ignore(remaining);
                     break;
-                case GUID.CompatibilityObject.str:
+                case AsfGuid.CompatibilityObject.str:
                     await this.tokenizer.ignore(remaining);
                     break;
-                case GUID.ASF_Index_Placeholder_Object.str:
+                case AsfGuid.ASF_Index_Placeholder_Object.str:
                     await this.tokenizer.ignore(remaining);
                     break;
                 default:

package/lib/ebml/EbmlIterator.d.ts

@@ -44,7 +44,6 @@ export type IElementListener = {
  * WEBM VP8 AUDIO FILE
  */
 export declare class EbmlIterator {
-    private padding;
     private parserMap;
     private ebmlMaxIDLength;
     private ebmlMaxSizeLength;

package/lib/ebml/EbmlIterator.js

@@ -27,7 +27,6 @@ export class EbmlIterator {
      * @param tokenizer
      */
     constructor(tokenizer) {
-        this.padding = 0;
         this.parserMap = new Map();
         this.ebmlMaxIDLength = 4;
         this.ebmlMaxSizeLength = 8;
@@ -110,12 +109,10 @@ export class EbmlIterator {
             else {
                 switch (element.id) {
                     case 0xec: // void
-                        this.padding += element.len;
                         await this.tokenizer.ignore(element.len);
                         break;
                     default:
                         debug(`parseEbml: parent=${getElementPath(dtdElement)}, unknown child: id=${element.id.toString(16)} at position=${elementPosition}`);
-                        this.padding += element.len;
                         await this.tokenizer.ignore(element.len);
                 }
             }
@@ -203,7 +200,7 @@ function linkParents(element) {
         Object.keys(element.container)
             .map(id => {
             const child = element.container[id];
-            child.id = Number.parseInt(id);
+            child.id = Number.parseInt(id, 10);
             return child;
         }).forEach(child => {
             child.parent = element;

package/lib/flac/FlacParser.d.ts

@@ -3,7 +3,6 @@ import { AbstractID3Parser } from '../id3v2/AbstractID3Parser.js';
 import type { IBlockStreamInfo } from './FlacToken.js';
 export declare class FlacParser extends AbstractID3Parser {
     private vorbisParser;
-    private padding;
     postId3v2Parse(): Promise<void>;
     private parseDataBlock;
     /**

package/lib/flac/FlacParser.js

@@ -14,7 +14,6 @@ export class FlacParser extends AbstractID3Parser {
     constructor() {
         super(...arguments);
         this.vorbisParser = new VorbisStream(this.metadata, this.options);
-        this.padding = 0;
     }
     async postId3v2Parse() {
         const fourCC = await this.tokenizer.readToken(FourCcToken);
@@ -39,7 +38,6 @@ export class FlacParser extends AbstractID3Parser {
             case Flac.BlockType.STREAMINFO:
                 return this.readBlockStreamInfo(blockHeader.length);
             case Flac.BlockType.PADDING:
-                this.padding += blockHeader.length;
                 break;
             case Flac.BlockType.APPLICATION:
                 break;

package/lib/id3v2/FrameParser.d.ts

@@ -1,5 +1,6 @@
 import { type ID3v2MajorVersion, type ITextEncoding } from './ID3v2Token.js';
 import type { IWarningCollector } from '../common/MetadataCollector.js';
+import { type IChapterInfo } from './ID3v2ChapterToken.js';
 interface ICustomTag {
     owner_identifier: string;
 }
@@ -24,6 +25,22 @@ export interface IGeneralEncapsulatedObject {
     description: string;
     data: Uint8Array;
 }
+export type Chapter = {
+    label: string;
+    info: IChapterInfo;
+    frames: Map<string, unknown>;
+};
+export type TableOfContents = {
+    label: string;
+    flags: {
+        /** If set, this is the top-level table of contents */
+        topLevel: boolean;
+        /** If set, the child element IDs are in a defined order */
+        ordered: boolean;
+    };
+    childElementIds: string[];
+    frames: Map<string, unknown>;
+};
 export declare function parseGenre(origVal: string): string[];
 export declare class FrameParser {
     private major;

package/lib/id3v2/FrameParser.js

@@ -5,6 +5,8 @@ import { AttachedPictureType, SyncTextHeader, TextEncodingToken, TextHeader } fr
 import { Genres } from '../id3v1/ID3v1Parser.js';
 import { makeUnexpectedFileContentError } from '../ParseError.js';
 import { decodeUintBE } from '../common/Util.js';
+import { ChapterInfo } from './ID3v2ChapterToken.js';
+import { getFrameHeaderLength, readFrameHeader } from './FrameHeader.js';
 const debug = initDebug('music-metadata:id3v2:frame-parser');
 const defaultEnc = 'latin1'; // latin1 == iso-8859-1;
 const urlEnc = { encoding: defaultEnc, bom: false };
@@ -109,6 +111,9 @@ export class FrameParser {
                     case 'TRK':
                     case 'TRCK':
                     case 'TPOS':
+                    case 'TIT1':
+                    case 'TIT2':
+                    case 'TIT3':
                         output = text;
                         break;
                     case 'TCOM':
@@ -137,11 +142,10 @@ export class FrameParser {
             }
             case 'TXXX': {
                 const idAndData = FrameParser.readIdentifierAndData(uint8Array.subarray(1), encoding);
-                const textTag = {
+                output = {
                     description: idAndData.id,
                     text: this.splitValue(type, util.decodeString(idAndData.data, encoding).replace(/\x00+$/, ''))
                 };
-                output = textTag;
                 break;
             }
             case 'PIC':
@@ -255,15 +259,15 @@ export class FrameParser {
             }
             case 'GEOB': { // General encapsulated object
                 // [encoding] <MIME> 0x00 <filename> 0x00/0x00 0x00 <description> 0x00/0x00 0x00 <data>
-                const { encoding: geobEncoding, bom: geobBom } = TextEncodingToken.get(uint8Array, 0);
+                const encoding = TextEncodingToken.get(uint8Array, 0);
                 uint8Array = uint8Array.subarray(1);
                 const mimeTypeStr = FrameParser.readNullTerminatedString(uint8Array, urlEnc);
                 const mimeType = mimeTypeStr.text;
                 uint8Array = uint8Array.subarray(mimeTypeStr.len);
-                const filenameStr = FrameParser.readNullTerminatedString(uint8Array, { encoding: geobEncoding, bom: geobBom });
+                const filenameStr = FrameParser.readNullTerminatedString(uint8Array, encoding);
                 const filename = filenameStr.text;
                 uint8Array = uint8Array.subarray(filenameStr.len);
-                const descriptionStr = FrameParser.readNullTerminatedString(uint8Array, { encoding: geobEncoding, bom: geobBom });
+                const descriptionStr = FrameParser.readNullTerminatedString(uint8Array, encoding);
                 const description = descriptionStr.text;
                 uint8Array = uint8Array.subarray(descriptionStr.len);
                 const geob = {
@@ -289,9 +293,9 @@ export class FrameParser {
                 break;
             case 'WXXX': {
                 // [encoding] <description> 0x00/0x00 0x00 <url>
-                const { encoding: wxxxEncoding, bom: wxxxBom } = TextEncodingToken.get(uint8Array, 0);
+                const encoding = TextEncodingToken.get(uint8Array, 0);
                 uint8Array = uint8Array.subarray(1);
-                const descriptionStr = FrameParser.readNullTerminatedString(uint8Array, { encoding: wxxxEncoding, bom: wxxxBom });
+                const descriptionStr = FrameParser.readNullTerminatedString(uint8Array, encoding);
                 const description = descriptionStr.text;
                 uint8Array = uint8Array.subarray(descriptionStr.len);
                 // URL is always ISO-8859-1
@@ -300,9 +304,9 @@ export class FrameParser {
             }
             case 'WFD':
             case 'WFED': {
-                const { encoding: wfdEncoding, bom: wfdBom } = TextEncodingToken.get(uint8Array, 0);
+                const encoding = TextEncodingToken.get(uint8Array, 0);
                 uint8Array = uint8Array.subarray(1);
-                output = FrameParser.readNullTerminatedString(uint8Array, { encoding: wfdEncoding, bom: wfdBom }).text;
+                output = FrameParser.readNullTerminatedString(uint8Array, encoding).text;
                 break;
             }
             case 'MCDI': {
@@ -310,6 +314,67 @@ export class FrameParser {
                 output = uint8Array.subarray(0, length);
                 break;
             }
+            // ID3v2 Chapters 1.0
+            // https://mutagen-specs.readthedocs.io/en/latest/id3/id3v2-chapters-1.0.html#chapter-frame
+            case 'CHAP': { //  // Chapter frame
+                debug("Reading CHAP");
+                fzero = util.findZero(uint8Array, defaultEnc);
+                const chapter = {
+                    label: util.decodeString(uint8Array.subarray(0, fzero), defaultEnc),
+                    info: ChapterInfo.get(uint8Array, fzero + 1),
+                    frames: new Map()
+                };
+                offset += fzero + 1 + ChapterInfo.len;
+                while (offset < length) {
+                    const subFrame = readFrameHeader(uint8Array.subarray(offset), this.major, this.warningCollector);
+                    const headerSize = getFrameHeaderLength(this.major);
+                    offset += headerSize;
+                    const subOutput = this.readData(uint8Array.subarray(offset, offset + subFrame.length), subFrame.id, includeCovers);
+                    offset += subFrame.length;
+                    chapter.frames.set(subFrame.id, subOutput);
+                }
+                output = chapter;
+                break;
+            }
+            // ID3v2 Chapters 1.0
+            // https://mutagen-specs.readthedocs.io/en/latest/id3/id3v2-chapters-1.0.html#table-of-contents-frame
+            case 'CTOC': { // Table of contents frame
+                debug('Reading CTOC');
+                // Element ID (null-terminated latin1)
+                const idEnd = util.findZero(uint8Array, defaultEnc);
+                const label = util.decodeString(uint8Array.subarray(0, idEnd), defaultEnc);
+                offset = idEnd + 1;
+                // Flags
+                const flags = uint8Array[offset++];
+                const topLevel = (flags & 0x02) !== 0;
+                const ordered = (flags & 0x01) !== 0;
+                // Child element IDs
+                const entryCount = uint8Array[offset++];
+                const childElementIds = [];
+                for (let i = 0; i < entryCount && offset < length; i++) {
+                    const end = util.findZero(uint8Array.subarray(offset), defaultEnc);
+                    const childId = util.decodeString(uint8Array.subarray(offset, offset + end), defaultEnc);
+                    childElementIds.push(childId);
+                    offset += end + 1;
+                }
+                const toc = {
+                    label,
+                    flags: { topLevel, ordered },
+                    childElementIds,
+                    frames: new Map()
+                };
+                // Optional embedded sub-frames (e.g. TIT2) follow after the child list
+                while (offset < length) {
+                    const subFrame = readFrameHeader(uint8Array.subarray(offset), this.major, this.warningCollector);
+                    const headerSize = getFrameHeaderLength(this.major);
+                    offset += headerSize;
+                    const subOutput = this.readData(uint8Array.subarray(offset, offset + subFrame.length), subFrame.id, includeCovers);
+                    offset += subFrame.length;
+                    toc.frames.set(subFrame.id, subOutput);
+                }
+                output = toc;
+                break;
+            }
             default:
                 debug(`Warning: unsupported id3v2-tag-type: ${type}`);
                 break;

package/lib/id3v2/ID3v2ChapterToken.d.ts

@@ -0,0 +1,11 @@
+import type { IGetToken } from 'strtok3';
+export interface IChapterInfo {
+    startTime: number;
+    endTime: number;
+    startOffset?: number;
+    endOffset?: number;
+}
+/**
+ * Data portion of `CHAP` sub frame
+ */
+export declare const ChapterInfo: IGetToken<IChapterInfo>;

package/lib/id3v2/ID3v2ChapterToken.js

@@ -0,0 +1,17 @@
+import * as Token from 'token-types';
+/**
+ * Data portion of `CHAP` sub frame
+ */
+export const ChapterInfo = {
+    len: 16,
+    get: (buf, off) => {
+        const startOffset = Token.UINT32_BE.get(buf, off + 8);
+        const endOffset = Token.UINT32_BE.get(buf, off + 12);
+        return {
+            startTime: Token.UINT32_BE.get(buf, off),
+            endTime: Token.UINT32_BE.get(buf, off + 4),
+            startOffset: startOffset === 0xFFFFFFFF ? undefined : startOffset,
+            endOffset: endOffset === 0xFFFFFFFF ? undefined : endOffset,
+        };
+    }
+};

package/lib/id3v2/ID3v2Parser.d.ts

@@ -23,4 +23,11 @@ export declare class ID3v2Parser {
     private handleTag;
     private addTag;
     private parseMetadata;
+    /**
+     * Convert parsed ID3v2 chapter frames (CHAP / CTOC) to generic `format.chapters`.
+     *
+     * This function expects the `native` tags already to contain parsed `CHAP` and `CTOC` frame values,
+     * as produced by `FrameParser.readData`.
+     */
+    private static mapId3v2Chapters;
 }

package/lib/id3v2/ID3v2Parser.js

@@ -62,7 +62,10 @@ export class ID3v2Parser {
         }
         this.id3Header = id3Header;
         this.headerType = (`ID3v2.${id3Header.version.major}`);
-        return id3Header.flags.isExtendedHeader ? this.parseExtendedHeader() : this.parseId3Data(id3Header.size);
+        await (id3Header.flags.isExtendedHeader ? this.parseExtendedHeader() : this.parseId3Data(id3Header.size));
+        // Post process
+        const chapters = ID3v2Parser.mapId3v2Chapters(this.metadata.native[this.headerType], this.metadata.format.sampleRate);
+        this.metadata.setFormat('chapters', chapters);
     }
     async parseExtendedHeader() {
         const extendedHeader = await this.tokenizer.readToken(ExtendedHeader);
@@ -116,6 +119,48 @@ export class ID3v2Parser {
         }
         return tags;
     }
+    /**
+     * Convert parsed ID3v2 chapter frames (CHAP / CTOC) to generic `format.chapters`.
+     *
+     * This function expects the `native` tags already to contain parsed `CHAP` and `CTOC` frame values,
+     * as produced by `FrameParser.readData`.
+     */
+    static mapId3v2Chapters(id3Tags, sampleRate) {
+        const chapFrames = id3Tags.filter(t => t.id === 'CHAP');
+        if (!chapFrames?.length)
+            return;
+        const tocFrames = id3Tags.filter(t => t.id === 'CTOC');
+        const topLevelToc = tocFrames?.find(t => t.value.flags?.topLevel);
+        const chapterById = new Map();
+        for (const chap of chapFrames) {
+            chapterById.set(chap.value.label, chap.value);
+        }
+        const orderedIds = topLevelToc?.value.childElementIds;
+        const chapters = [];
+        const source = orderedIds ?? [...chapterById.keys()];
+        for (const id of source) {
+            const chap = chapterById.get(id);
+            if (!chap)
+                continue;
+            const frames = chap.frames;
+            const title = frames.get('TIT2');
+            if (!title)
+                continue; // title is required
+            chapters.push({
+                id,
+                title,
+                url: frames.get('WXXX'),
+                start: chap.info.startTime / 1000,
+                end: chap.info.endTime / 1000,
+                image: frames.get('APIC')
+            });
+        }
+        // If no ordered CTOC, sort by time
+        if (!orderedIds) {
+            chapters.sort((a, b) => a.start - b.start);
+        }
+        return chapters.length ? chapters : undefined;
+    }
 }
 function makeUnexpectedMajorVersionError(majorVer) {
     throw new Id3v2ContentError(`Unexpected majorVer: ${majorVer}`);

package/lib/id3v2/ID3v2Token.d.ts

@@ -57,10 +57,7 @@ export type TimestampFormat = typeof TimestampFormat[keyof typeof TimestampForma
  * 28 bits (representing up to 256MB) integer, the msb is 0 to avoid 'false syncsignals'.
  * 4 * %0xxxxxxx
  */
-export declare const UINT32SYNCSAFE: {
-    get: (buf: Uint8Array, off: number) => number;
-    len: number;
-};
+export declare const UINT32SYNCSAFE: IGetToken<number>;
 /**
  * ID3v2 tag header
  */

package/lib/mpeg/MpegParser.d.ts

@@ -16,13 +16,11 @@ export declare class MpegContentError extends MpegContentError_base {
 export declare class MpegParser extends AbstractID3Parser {
     private frameCount;
     private syncFrameCount;
-    private countSkipFrameData;
     private totalDataLength;
     private audioFrameHeader?;
     private bitrates;
     private offset;
     private frame_size;
-    private crc;
     private calculateEofDuration;
     private samplesPerFrame;
     private buf_frame_header;

package/lib/mpeg/MpegParser.js

@@ -233,12 +233,10 @@ export class MpegParser extends AbstractID3Parser {
         super(...arguments);
         this.frameCount = 0;
         this.syncFrameCount = -1;
-        this.countSkipFrameData = 0;
         this.totalDataLength = 0;
         this.bitrates = [];
         this.offset = 0;
         this.frame_size = 0;
-        this.crc = null;
         this.calculateEofDuration = false;
         this.samplesPerFrame = null;
         this.buf_frame_header = new Uint8Array(4);
@@ -467,8 +465,8 @@ export class MpegParser extends AbstractID3Parser {
         return false;
     }
     async parseCrc() {
-        this.crc = await this.tokenizer.readNumber(Token.INT16_BE);
-        this.offset += 2;
+        await this.tokenizer.ignore(Token.INT16_BE.len); // Ignore CRC
+        this.offset += Token.INT16_BE.len;
         return this.skipSideInformation();
     }
     async skipSideInformation() {
@@ -561,7 +559,6 @@ export class MpegParser extends AbstractID3Parser {
         if (frameDataLeft < 0)
             throw new MpegContentError('frame-data-left cannot be negative');
         await this.tokenizer.ignore(frameDataLeft);
-        this.countSkipFrameData += frameDataLeft;
     }
     areAllSame(array) {
         const first = array[0];

package/lib/ogg/vorbis/VorbisStream.d.ts

@@ -37,7 +37,7 @@ export declare class VorbisStream implements IPageConsumer {
     flush(): Promise<void>;
     parseUserComment(pageData: Uint8Array, offset: number): Promise<number>;
     addTag(id: string, value: string | IVorbisPicture): Promise<void>;
-    calculateDuration(enfOfStream: boolean): void;
+    calculateDuration(_enfOfStream: boolean): void;
     /**
      * Parse first Ogg/Vorbis page
      * @param _header

package/lib/ogg/vorbis/VorbisStream.js

@@ -77,7 +77,7 @@ export class VorbisStream {
         }
         await this.metadata.addTag('vorbis', id, value);
     }
-    calculateDuration(enfOfStream) {
+    calculateDuration(_enfOfStream) {
         if (this.lastPageHeader && this.metadata.format.sampleRate && this.lastPageHeader.absoluteGranulePosition >= 0) {
             // Calculate duration
             this.metadata.setFormat('numberOfSamples', this.lastPageHeader.absoluteGranulePosition);

package/lib/type.d.ts

@@ -484,25 +484,46 @@ export interface ITag {
     id: string;
     value: AnyTagValue;
 }
+export interface IUrl {
+    url: string;
+    description: string;
+}
 export interface IChapter {
+    /**
+     * Internal chapter reference
+     */
+    id?: string;
     /**
      * Chapter title
      */
     title: string;
+    /**
+     * URL
+     */
+    url?: IUrl;
     /**
      * Audio offset in sample number, 0 is the first sample.
      * Duration offset is sampleOffset / format.sampleRate
      */
-    sampleOffset: number;
+    sampleOffset?: number;
     /**
      * Timestamp where the chapter starts
      * Chapter timestamp is start/timeScale in seconds.
      */
     start: number;
     /**
-     * Time value that indicates the time scale for chapter tracks, the number of time units that pass per second in its time coordinate system.
+     * Timestamp where the chapter end
+     * Chapter timestamp is start/timeScale in seconds.
+     */
+    end?: number;
+    /**
+     * Time value that indicates the timescale for chapter tracks, the number of time units that pass per second in its time coordinate system.
+     */
+    timeScale?: number;
+    /**
+     * Picture
      */
-    timeScale: number;
+    image?: IPicture;
 }
 /**
  * Flat list of tags

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "music-metadata",
   "description": "Music metadata parser for Node.js, supporting virtual any audio and tag format.",
-  "version": "11.10.5",
+  "version": "11.11.0",
   "author": {
     "name": "Borewit",
     "url": "https://github.com/Borewit"
@@ -85,7 +85,9 @@
     "parser",
     "bwf",
     "slt",
-    "lyrics"
+    "lyrics",
+    "Chapters",
+    "ID3v2 Chapters"
   ],
   "scripts": {
     "clean": "del-cli 'lib/**/*.js' 'lib/**/*.js.map' 'lib/**/*.d.ts' 'test/**/*.js' 'test/**/*.js.map' 'test/**/*.js' 'test/**/*.js.map' 'doc-gen/**/*.js' 'doc-gen/**/*.js.map'",
@@ -110,21 +112,22 @@
     "@tokenizer/token": "^0.3.0",
     "content-type": "^1.0.5",
     "debug": "^4.4.3",
-    "file-type": "^21.2.0",
+    "file-type": "^21.3.0",
     "media-typer": "^1.1.0",
     "strtok3": "^10.3.4",
     "token-types": "^6.1.2",
-    "uint8array-extras": "^1.5.0"
+    "uint8array-extras": "^1.5.0",
+    "win-guid": "^0.2.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.3.10",
+    "@biomejs/biome": "2.3.11",
     "@types/chai": "^5.2.3",
     "@types/chai-as-promised": "^8.0.2",
     "@types/content-type": "^1.1.9",
     "@types/debug": "^4.1.12",
     "@types/media-typer": "^1.1.3",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.0.10",
     "c8": "^10.1.3",
     "chai": "^6.2.2",
     "chai-as-promised": "^8.0.2",

package/lib/asf/GUID.d.ts

@@ -1,83 +0,0 @@
-/**
- * Ref:
- * - https://tools.ietf.org/html/draft-fleischman-asf-01, Appendix A: ASF GUIDs
- * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
- * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/index.html
- * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
- *
- * ASF File Structure:
- * - https://msdn.microsoft.com/en-us/library/windows/desktop/ee663575(v=vs.85).aspx
- *
- * ASF GUIDs:
- * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
- * - https://github.com/dji-sdk/FFmpeg/blob/master/libavformat/asf.c
- */
-export default class GUID {
-    static HeaderObject: GUID;
-    static DataObject: GUID;
-    static SimpleIndexObject: GUID;
-    static IndexObject: GUID;
-    static MediaObjectIndexObject: GUID;
-    static TimecodeIndexObject: GUID;
-    static FilePropertiesObject: GUID;
-    static StreamPropertiesObject: GUID;
-    static HeaderExtensionObject: GUID;
-    static CodecListObject: GUID;
-    static ScriptCommandObject: GUID;
-    static MarkerObject: GUID;
-    static BitrateMutualExclusionObject: GUID;
-    static ErrorCorrectionObject: GUID;
-    static ContentDescriptionObject: GUID;
-    static ExtendedContentDescriptionObject: GUID;
-    static ContentBrandingObject: GUID;
-    static StreamBitratePropertiesObject: GUID;
-    static ContentEncryptionObject: GUID;
-    static ExtendedContentEncryptionObject: GUID;
-    static DigitalSignatureObject: GUID;
-    static PaddingObject: GUID;
-    static ExtendedStreamPropertiesObject: GUID;
-    static AdvancedMutualExclusionObject: GUID;
-    static GroupMutualExclusionObject: GUID;
-    static StreamPrioritizationObject: GUID;
-    static BandwidthSharingObject: GUID;
-    static LanguageListObject: GUID;
-    static MetadataObject: GUID;
-    static MetadataLibraryObject: GUID;
-    static IndexParametersObject: GUID;
-    static MediaObjectIndexParametersObject: GUID;
-    static TimecodeIndexParametersObject: GUID;
-    static CompatibilityObject: GUID;
-    static AdvancedContentEncryptionObject: GUID;
-    static AudioMedia: GUID;
-    static VideoMedia: GUID;
-    static CommandMedia: GUID;
-    static JFIF_Media: GUID;
-    static Degradable_JPEG_Media: GUID;
-    static FileTransferMedia: GUID;
-    static BinaryMedia: GUID;
-    static ASF_Index_Placeholder_Object: GUID;
-    static fromBin(bin: Uint8Array, offset?: number): GUID;
-    /**
-     * Decode GUID in format like "B503BF5F-2EA9-CF11-8EE3-00C00C205365"
-     * @param objectId Binary GUID
-     * @param offset Read offset in bytes, default 0
-     * @returns GUID as dashed hexadecimal representation
-     */
-    static decode(objectId: Uint8Array, offset?: number): string;
-    /**
-     * Decode stream type
-     * @param mediaType Media type GUID
-     * @returns Media type
-     */
-    static decodeMediaType(mediaType: GUID): 'audio' | 'video' | 'command' | 'degradable-jpeg' | 'file-transfer' | 'binary' | undefined;
-    /**
-     * Encode GUID
-     * @param guid GUID like: "B503BF5F-2EA9-CF11-8EE3-00C00C205365"
-     * @returns Encoded Binary GUID
-     */
-    static encode(str: string): Uint8Array;
-    str: string;
-    constructor(str: string);
-    equals(guid: GUID): boolean;
-    toBin(): Uint8Array;
-}

package/lib/asf/GUID.js

@@ -1,118 +0,0 @@
-import { hexToUint8Array, uint8ArrayToHex } from 'uint8array-extras';
-/**
- * Ref:
- * - https://tools.ietf.org/html/draft-fleischman-asf-01, Appendix A: ASF GUIDs
- * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
- * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/index.html
- * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
- *
- * ASF File Structure:
- * - https://msdn.microsoft.com/en-us/library/windows/desktop/ee663575(v=vs.85).aspx
- *
- * ASF GUIDs:
- * - http://drang.s4.xrea.com/program/tips/id3tag/wmp/10_asf_guids.html
- * - https://github.com/dji-sdk/FFmpeg/blob/master/libavformat/asf.c
- */
-class GUID {
-    static fromBin(bin, offset = 0) {
-        return new GUID(GUID.decode(bin, offset));
-    }
-    /**
-     * Decode GUID in format like "B503BF5F-2EA9-CF11-8EE3-00C00C205365"
-     * @param objectId Binary GUID
-     * @param offset Read offset in bytes, default 0
-     * @returns GUID as dashed hexadecimal representation
-     */
-    static decode(objectId, offset = 0) {
-        const view = new DataView(objectId.buffer, offset);
-        const guid = `${view.getUint32(0, true).toString(16)}-${view.getUint16(4, true).toString(16)}-${view.getUint16(6, true).toString(16)}-${view.getUint16(8).toString(16)}-${uint8ArrayToHex(objectId.subarray(offset + 10, offset + 16))}`;
-        return guid.toUpperCase();
-    }
-    /**
-     * Decode stream type
-     * @param mediaType Media type GUID
-     * @returns Media type
-     */
-    static decodeMediaType(mediaType) {
-        switch (mediaType.str) {
-            case GUID.AudioMedia.str: return 'audio';
-            case GUID.VideoMedia.str: return 'video';
-            case GUID.CommandMedia.str: return 'command';
-            case GUID.Degradable_JPEG_Media.str: return 'degradable-jpeg';
-            case GUID.FileTransferMedia.str: return 'file-transfer';
-            case GUID.BinaryMedia.str: return 'binary';
-        }
-    }
-    /**
-     * Encode GUID
-     * @param guid GUID like: "B503BF5F-2EA9-CF11-8EE3-00C00C205365"
-     * @returns Encoded Binary GUID
-     */
-    static encode(str) {
-        const bin = new Uint8Array(16);
-        const view = new DataView(bin.buffer);
-        view.setUint32(0, Number.parseInt(str.substring(0, 8), 16), true);
-        view.setUint16(4, Number.parseInt(str.substring(9, 13), 16), true);
-        view.setUint16(6, Number.parseInt(str.substring(14, 18), 16), true);
-        bin.set(hexToUint8Array(str.substring(19, 23)), 8);
-        bin.set(hexToUint8Array(str.substring(24)), 10);
-        return bin;
-    }
-    constructor(str) {
-        this.str = str;
-    }
-    equals(guid) {
-        return this.str === guid.str;
-    }
-    toBin() {
-        return GUID.encode(this.str);
-    }
-}
-// 10.1 Top-level ASF object GUIDs
-GUID.HeaderObject = new GUID("75B22630-668E-11CF-A6D9-00AA0062CE6C");
-GUID.DataObject = new GUID("75B22636-668E-11CF-A6D9-00AA0062CE6C");
-GUID.SimpleIndexObject = new GUID("33000890-E5B1-11CF-89F4-00A0C90349CB");
-GUID.IndexObject = new GUID("D6E229D3-35DA-11D1-9034-00A0C90349BE");
-GUID.MediaObjectIndexObject = new GUID("FEB103F8-12AD-4C64-840F-2A1D2F7AD48C");
-GUID.TimecodeIndexObject = new GUID("3CB73FD0-0C4A-4803-953D-EDF7B6228F0C");
-// 10.2 Header Object GUIDs
-GUID.FilePropertiesObject = new GUID("8CABDCA1-A947-11CF-8EE4-00C00C205365");
-GUID.StreamPropertiesObject = new GUID("B7DC0791-A9B7-11CF-8EE6-00C00C205365");
-GUID.HeaderExtensionObject = new GUID("5FBF03B5-A92E-11CF-8EE3-00C00C205365");
-GUID.CodecListObject = new GUID("86D15240-311D-11D0-A3A4-00A0C90348F6");
-GUID.ScriptCommandObject = new GUID("1EFB1A30-0B62-11D0-A39B-00A0C90348F6");
-GUID.MarkerObject = new GUID("F487CD01-A951-11CF-8EE6-00C00C205365");
-GUID.BitrateMutualExclusionObject = new GUID("D6E229DC-35DA-11D1-9034-00A0C90349BE");
-GUID.ErrorCorrectionObject = new GUID("75B22635-668E-11CF-A6D9-00AA0062CE6C");
-GUID.ContentDescriptionObject = new GUID("75B22633-668E-11CF-A6D9-00AA0062CE6C");
-GUID.ExtendedContentDescriptionObject = new GUID("D2D0A440-E307-11D2-97F0-00A0C95EA850");
-GUID.ContentBrandingObject = new GUID("2211B3FA-BD23-11D2-B4B7-00A0C955FC6E");
-GUID.StreamBitratePropertiesObject = new GUID("7BF875CE-468D-11D1-8D82-006097C9A2B2");
-GUID.ContentEncryptionObject = new GUID("2211B3FB-BD23-11D2-B4B7-00A0C955FC6E");
-GUID.ExtendedContentEncryptionObject = new GUID("298AE614-2622-4C17-B935-DAE07EE9289C");
-GUID.DigitalSignatureObject = new GUID("2211B3FC-BD23-11D2-B4B7-00A0C955FC6E");
-GUID.PaddingObject = new GUID("1806D474-CADF-4509-A4BA-9AABCB96AAE8");
-// 10.3 Header Extension Object GUIDs
-GUID.ExtendedStreamPropertiesObject = new GUID("14E6A5CB-C672-4332-8399-A96952065B5A");
-GUID.AdvancedMutualExclusionObject = new GUID("A08649CF-4775-4670-8A16-6E35357566CD");
-GUID.GroupMutualExclusionObject = new GUID("D1465A40-5A79-4338-B71B-E36B8FD6C249");
-GUID.StreamPrioritizationObject = new GUID("D4FED15B-88D3-454F-81F0-ED5C45999E24");
-GUID.BandwidthSharingObject = new GUID("A69609E6-517B-11D2-B6AF-00C04FD908E9");
-GUID.LanguageListObject = new GUID("7C4346A9-EFE0-4BFC-B229-393EDE415C85");
-GUID.MetadataObject = new GUID("C5F8CBEA-5BAF-4877-8467-AA8C44FA4CCA");
-GUID.MetadataLibraryObject = new GUID("44231C94-9498-49D1-A141-1D134E457054");
-GUID.IndexParametersObject = new GUID("D6E229DF-35DA-11D1-9034-00A0C90349BE");
-GUID.MediaObjectIndexParametersObject = new GUID("6B203BAD-3F11-48E4-ACA8-D7613DE2CFA7");
-GUID.TimecodeIndexParametersObject = new GUID("F55E496D-9797-4B5D-8C8B-604DFE9BFB24");
-GUID.CompatibilityObject = new GUID("26F18B5D-4584-47EC-9F5F-0E651F0452C9");
-GUID.AdvancedContentEncryptionObject = new GUID("43058533-6981-49E6-9B74-AD12CB86D58C");
-// 10.4 Stream Properties Object Stream Type GUIDs
-GUID.AudioMedia = new GUID("F8699E40-5B4D-11CF-A8FD-00805F5C442B");
-GUID.VideoMedia = new GUID("BC19EFC0-5B4D-11CF-A8FD-00805F5C442B");
-GUID.CommandMedia = new GUID("59DACFC0-59E6-11D0-A3AC-00A0C90348F6");
-GUID.JFIF_Media = new GUID("B61BE100-5B4E-11CF-A8FD-00805F5C442B");
-GUID.Degradable_JPEG_Media = new GUID("35907DE0-E415-11CF-A917-00805F5C442B");
-GUID.FileTransferMedia = new GUID("91BD222C-F21C-497A-8B6D-5AA86BFC0185");
-GUID.BinaryMedia = new GUID("3AFB65E2-47EF-40F2-AC2C-70A90D71D343");
-GUID.ASF_Index_Placeholder_Object = new GUID("D9AADE20-7C17-4F9C-BC28-8555DD98E2A2");
-export default GUID;