music-metadata 11.1.1 → 11.2.1

package/README.md

@@ -788,9 +788,10 @@ For older Node.js version < 22, you need to dynamically import **music-metadata*
 })();
 ```
 
-For CommonJS TypeScript projects, using a Node.js version < 22, you can use [load-esm](https://github.com/Borewit/load-esm):
+For CommonJS TypeScript projects, I recommend to avoid using `commonjs` for the TypeScript compiler `module` option, 
+and either use `node16` or `nodenext`, which enable utilizing [dynamic import](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/import).
 
-This method shall has replaced the embedded CJS loader function: `loadMusicMetadata()`.
+If you do want to use the classic `commonjs` option, this is how you can get the _dynamic import_ to work.
 
 ```js
 import {loadEsm} from 'load-esm';
@@ -801,6 +802,8 @@ import {loadEsm} from 'load-esm';
 })();
 ```
 
+When you use Node.js version ≥ 22, which supports loading ESM modules via require, this compensates for that issue.
+
 ## Frequently Asked Questions
 
 ###  How can I traverse (a long) list of files?

package/lib/mp4/MP4Parser.js

@@ -462,6 +462,9 @@ export class MP4Parser extends BasicParser {
         }
         const chapters = [];
         for (let i = 0; i < chapterTrack.chunkOffsetTable.length && len > 0; ++i) {
+            const start = chapterTrack.timeToSampleTable
+                .slice(0, i)
+                .reduce((acc, cur) => acc + cur.duration, 0);
             const chunkOffset = chapterTrack.chunkOffsetTable[i];
             const nextChunkLen = chunkOffset - this.tokenizer.position;
             const sampleSize = chapterTrack.sampleSize > 0 ? chapterTrack.sampleSize : chapterTrack.sampleSizeTable[i];
@@ -473,6 +476,8 @@ export class MP4Parser extends BasicParser {
             debug(`Chapter ${i + 1}: ${title}`);
             const chapter = {
                 title,
+                timeScale: chapterTrack.timeScale,
+                start,
                 sampleOffset: this.findSampleOffset(track, this.tokenizer.position)
             };
             debug(`Chapter title=${chapter.title}, offset=${chapter.sampleOffset}/${this.tracks[0].duration}`);

package/lib/type.d.ts

@@ -485,6 +485,15 @@ export interface IChapter {
      * Duration offset is sampleOffset / format.sampleRate
      */
     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.
+     */
+    timeScale: number;
 }
 /**
  * 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.1.1",
+  "version": "11.2.1",
   "author": {
     "name": "Borewit",
     "url": "https://github.com/Borewit"
@@ -107,8 +107,7 @@
     "@tokenizer/token": "^0.3.0",
     "content-type": "^1.0.5",
     "debug": "^4.4.0",
-    "file-type": "^19.6.0",
-    "link": "^2.1.1",
+    "file-type": "^20.4.1",
     "media-typer": "^1.1.0",
     "strtok3": "^10.2.2",
     "token-types": "^6.0.0",
@@ -122,7 +121,7 @@
     "@types/debug": "^4.1.12",
     "@types/media-typer": "^1.1.3",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^22.14.0",
+    "@types/node": "^22.14.1",
     "c8": "^10.1.3",
     "chai": "^5.2.0",
     "chai-as-promised": "^8.0.1",
@@ -133,7 +132,7 @@
     "remark-cli": "^12.0.1",
     "remark-preset-lint-consistent": "^6.0.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   },
   "engines": {
     "node": ">=18"
@@ -145,5 +144,5 @@
   "bugs": {
     "url": "https://github.com/Borewit/music-metadata/issues"
   },
-  "packageManager": "yarn@4.8.1"
+  "packageManager": "yarn@4.9.1"
 }