mediabunny 1.0.2 → 1.0.4

package/README.md

@@ -5,7 +5,7 @@
 [![](https://img.shields.io/npm/dm/mediabunny)](https://www.npmjs.com/package/mediabunny)
 
 <div align="center">
-    <img src="./docs/public/mediabunny-logo.svg" height="180">
+    <img src="./docs/public/mediabunny-logo.svg" width="180" height="180">
 </div>
 
 Mediabunny is a JavaScript library for reading, writing, and converting media files (like MP4, WebM, MP3), directly in the browser. It aims to be a complete toolkit for high-performance media operations on the web. It's written from scratch in pure TypeScript, has zero dependencies, is very performant, and is extremely tree-shakable, meaning you only include what you use. You can think of it a bit like [FFmpeg](https://ffmpeg.org/), but built from the ground up for the web.
@@ -16,11 +16,11 @@ Mediabunny is a JavaScript library for reading, writing, and converting media fi
 
 <div align="center">
   <a href="https://www.gling.ai/" target="_blank">
-    <img src="./docs/public/sponsors/gling.svg" height="60" alt="Gling AI">
+    <img src="./docs/public/sponsors/gling.svg" width="60" height="60" alt="Gling AI">
   </a>
   &nbsp;&nbsp;&nbsp;&nbsp;
   <a href="https://diffusion.studio/" target="_blank">
-    <img src="./docs/public/sponsors/diffusionstudio.png" height="60" alt="Diffusion Studio">
+    <img src="./docs/public/sponsors/diffusionstudio.png" width="60" height="60" alt="Diffusion Studio">
   </a>
 </div>
 
@@ -152,7 +152,7 @@ For development, clone this repository and install it using a modern version of
 
 ```bash
 npm install # Install dependencies
-npm run watch # Development build with watch mode
+npm run watch # Build bundles on watch mode
 
 npm run build # Production build with type definitions
 

package/dist/mediabunny.d.ts

@@ -1,3 +1,6 @@
+/// <reference types="dom-mediacapture-transform" />
+/// <reference types="dom-webcodecs" />
+
 /**
  * List of all input format singletons. If you don't need to support all input formats, you should specify the
  * formats individually for better tree shaking.
@@ -1983,5 +1986,4 @@ export declare type WrappedCanvas = {
 };
 
 export { }
-
-export as namespace Mediabunny;
+export as namespace Mediabunny;

package/dist/modules/codec-data.d.ts

@@ -0,0 +1,95 @@
+/*!
+ * Copyright (c) 2025-present, Vanilagy and contributors
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+/** Converts an AVC packet in Annex B format to length-prefixed format. */
+export declare const transformAnnexBToLengthPrefixed: (packetData: Uint8Array) => Uint8Array<ArrayBuffer> | null;
+export type AvcDecoderConfigurationRecord = {
+    configurationVersion: number;
+    avcProfileIndication: number;
+    profileCompatibility: number;
+    avcLevelIndication: number;
+    lengthSizeMinusOne: number;
+    sequenceParameterSets: Uint8Array[];
+    pictureParameterSets: Uint8Array[];
+    chromaFormat: number | null;
+    bitDepthLumaMinus8: number | null;
+    bitDepthChromaMinus8: number | null;
+    sequenceParameterSetExt: Uint8Array[] | null;
+};
+/** Builds an AvcDecoderConfigurationRecord from an AVC packet in Annex B format. */
+export declare const extractAvcDecoderConfigurationRecord: (packetData: Uint8Array) => AvcDecoderConfigurationRecord | null;
+/** Serializes an AvcDecoderConfigurationRecord into the format specified in Section 5.3.3.1 of ISO 14496-15. */
+export declare const serializeAvcDecoderConfigurationRecord: (record: AvcDecoderConfigurationRecord) => Uint8Array<ArrayBuffer>;
+export type HevcDecoderConfigurationRecord = {
+    configurationVersion: number;
+    generalProfileSpace: number;
+    generalTierFlag: number;
+    generalProfileIdc: number;
+    generalProfileCompatibilityFlags: number;
+    generalConstraintIndicatorFlags: Uint8Array;
+    generalLevelIdc: number;
+    minSpatialSegmentationIdc: number;
+    parallelismType: number;
+    chromaFormatIdc: number;
+    bitDepthLumaMinus8: number;
+    bitDepthChromaMinus8: number;
+    avgFrameRate: number;
+    constantFrameRate: number;
+    numTemporalLayers: number;
+    temporalIdNested: number;
+    lengthSizeMinusOne: number;
+    arrays: {
+        arrayCompleteness: number;
+        nalUnitType: number;
+        nalUnits: Uint8Array[];
+    }[];
+};
+/** Builds a HevcDecoderConfigurationRecord from an HEVC packet in Annex B format. */
+export declare const extractHevcDecoderConfigurationRecord: (packetData: Uint8Array) => HevcDecoderConfigurationRecord | null;
+/** Serializes an HevcDecoderConfigurationRecord into the format specified in Section 8.3.3.1 of ISO 14496-15. */
+export declare const serializeHevcDecoderConfigurationRecord: (record: HevcDecoderConfigurationRecord) => Uint8Array<ArrayBuffer>;
+export type Vp9CodecInfo = {
+    profile: number;
+    level: number;
+    bitDepth: number;
+    chromaSubsampling: number;
+    videoFullRangeFlag: number;
+    colourPrimaries: number;
+    transferCharacteristics: number;
+    matrixCoefficients: number;
+};
+export declare const extractVp9CodecInfoFromPacket: (packet: Uint8Array) => Vp9CodecInfo | null;
+export type Av1CodecInfo = {
+    profile: number;
+    level: number;
+    tier: number;
+    bitDepth: number;
+    monochrome: number;
+    chromaSubsamplingX: number;
+    chromaSubsamplingY: number;
+    chromaSamplePosition: number;
+};
+/**
+ * When AV1 codec information is not provided by the container, we can still try to extract the information by digging
+ * into the AV1 bitstream.
+ */
+export declare const extractAv1CodecInfoFromPacket: (packet: Uint8Array) => Av1CodecInfo | null;
+export declare const parseOpusIdentificationHeader: (bytes: Uint8Array) => {
+    outputChannelCount: number;
+    preSkip: number;
+    inputSampleRate: number;
+    outputGain: number;
+    channelMappingFamily: number;
+    channelMappingTable: Uint8Array<ArrayBufferLike> | null;
+};
+export declare const parseOpusTocByte: (packet: Uint8Array) => {
+    durationInSamples: number;
+};
+export declare const parseModesFromVorbisSetupPacket: (setupHeader: Uint8Array) => {
+    modeBlockflags: number[];
+};
+//# sourceMappingURL=codec-data.d.ts.map

package/dist/modules/codec-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-data.d.ts","sourceRoot":"","sources":["../../src/codec-data.ts"],"names":[],"mappings":"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"}